android_list_emulators
List available Android emulators to manage virtual devices for development and testing.
Instructions
List available Android emulators
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/android.ts:509-534 (handler)The main handler function for 'android_list_emulators' tool. Executes 'emulator -list-avds' to list available AVDs, parses the output, checks which are running using the global runningEmulators map, and returns structured data with emulator list, counts, and status.
handler: async () => { const result = await processExecutor.execute('emulator', ['-list-avds']); if (result.exitCode !== 0) { throw new Error(`Emulator listing failed: ${result.stderr}`); } const emulators = result.stdout .split('\n') .map(line => line.trim()) .filter(line => line.length > 0) .map(name => ({ name, isRunning: runningEmulators.has(name), pid: runningEmulators.get(name) || null, })); return { success: true, data: { emulators, totalCount: emulators.length, runningCount: emulators.filter(e => e.isRunning).length, }, }; } - src/tools/android.ts:501-535 (registration)Registration of the 'android_list_emulators' tool within the createAndroidTools factory function. Defines name, description, empty inputSchema (no parameters required), and attaches the handler.
tools.set('android_list_emulators', { name: 'android_list_emulators', description: 'List available Android emulators', inputSchema: { type: 'object', properties: {}, required: [] }, handler: async () => { const result = await processExecutor.execute('emulator', ['-list-avds']); if (result.exitCode !== 0) { throw new Error(`Emulator listing failed: ${result.stderr}`); } const emulators = result.stdout .split('\n') .map(line => line.trim()) .filter(line => line.length > 0) .map(name => ({ name, isRunning: runningEmulators.has(name), pid: runningEmulators.get(name) || null, })); return { success: true, data: { emulators, totalCount: emulators.length, runningCount: emulators.filter(e => e.isRunning).length, }, }; } }); - src/tools/android.ts:42-47 (helper)Global runningEmulators map used by the handler to determine if an emulator is running and its PID. Initialized and used within createAndroidTools.
* Maps AVD names to process IDs. * * @type {Map<string, number>} */ let runningEmulators: Map<string, number>; - src/utils/tool-categories.ts:121-129 (registration)Metadata registration in TOOL_REGISTRY for categorization, requirements (requires 'emulator' tool), performance expectations, and testing safety.
'android_list_emulators': { name: 'android_list_emulators', category: ToolCategory.ESSENTIAL, platform: 'android', requiredTools: [RequiredTool.EMULATOR], description: 'List available Android emulators', safeForTesting: true, performance: { expectedDuration: 1000, timeout: 15000 } },