adb_list_files
List files in a directory on an Android device using ADB commands to view and manage device file systems.
Instructions
List files in a directory on the device
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| remotePath | Yes | Remote directory path on device | |
| deviceId | No | Device ID (optional) |
Implementation Reference
- src/tools/file.ts:88-144 (handler)The listFiles method in the FileTools class that implements the tool logic: checks device connection, executes 'adb shell ls -la' command, parses the ls output into structured file information (permissions, size, date, name), and returns formatted result.
async listFiles(remotePath: string, deviceId?: string) { try { const connected = await this.adbClient.isDeviceConnected(deviceId); if (!connected) { return { success: false, error: 'Device not connected', message: 'Cannot list files - device is not connected' }; } const command = `shell ls -la "${remotePath}"`; const result = await this.adbClient.executeCommand(command, deviceId); if (!result.success) { return { success: false, error: result.error, message: 'Failed to list files' }; } const files = result.output .split('\n') .slice(1) // Skip the first line (total) .map(line => { const parts = line.trim().split(/\s+/); if (parts.length >= 9) { return { permissions: parts[0], size: parts[4], date: `${parts[5]} ${parts[6]} ${parts[7]}`, name: parts.slice(8).join(' ') }; } return null; }) .filter(file => file !== null); return { success: true, data: { path: remotePath, files, count: files.length, deviceId: deviceId || this.adbClient.getDefaultDevice() }, message: `Listed ${files.length} files in ${remotePath}` }; } catch (error: any) { return { success: false, error: error.message, message: 'Failed to list files' }; } } - src/index.ts:336-353 (schema)Defines the tool metadata including name, description, and input schema for 'adb_list_files' in the ListTools response.
{ name: 'adb_list_files', description: 'List files in a directory on the device', inputSchema: { type: 'object', properties: { remotePath: { type: 'string', description: 'Remote directory path on device', }, deviceId: { type: 'string', description: 'Device ID (optional)', }, }, required: ['remotePath'], }, }, - src/index.ts:469-470 (registration)Registers the tool handler by dispatching 'adb_list_files' calls to the FileTools.listFiles method in the CallToolRequest switch statement.
case 'adb_list_files': return await this.handleToolCall(this.fileTools.listFiles(args?.remotePath as string, args?.deviceId as string));