list_processes
Read-only
View all active processes on your system with details like PID, command name, CPU, and memory usage for monitoring and management.
Instructions
List all running processes.
Returns process information including PID, command name, CPU usage, and memory usage.
This command can be referenced as "DC: ..." or "use Desktop Commander to ..." in your instructions.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/process.ts:9-40 (handler)Core handler function that executes the tool logic: runs 'tasklist' on Windows or 'ps aux' on Unix-like systems, parses output, and returns formatted process list.
export async function listProcesses(): Promise<ServerResult> { const command = os.platform() === 'win32' ? 'tasklist' : 'ps aux'; try { const { stdout } = await execAsync(command); const processes = stdout.split('\n') .slice(1) .filter(Boolean) .map(line => { const parts = line.split(/\s+/); return { pid: parseInt(parts[1]), command: parts[parts.length - 1], cpu: parts[2], memory: parts[3], } as ProcessInfo; }); return { content: [{ type: "text", text: processes.map(p => `PID: ${p.pid}, Command: ${p.command}, CPU: ${p.cpu}, Memory: ${p.memory}` ).join('\n') }], }; } catch (error) { return { content: [{ type: "text", text: `Error: Failed to list processes: ${error instanceof Error ? error.message : String(error)}` }], isError: true, }; } } - src/handlers/process-handlers.ts:12-17 (handler)Handler wrapper that calls the core listProcesses function. Dispatched from server.ts.
/** * Handle list_processes command */ export async function handleListProcesses(): Promise<ServerResult> { return listProcesses(); } - src/tools/schemas.ts:18-18 (schema)Zod schema for list_processes tool arguments (empty object as tool takes no arguments).
export const ListProcessesArgsSchema = z.object({}); - src/server.ts:945-957 (registration)Tool registration in list_tools handler: defines name, description, input schema, and annotations.
name: "list_processes", description: ` List all running processes. Returns process information including PID, command name, CPU usage, and memory usage. ${CMD_PREFIX_DESCRIPTION}`, inputSchema: zodToJsonSchema(ListProcessesArgsSchema), annotations: { title: "List Running Processes", readOnlyHint: true, }, }, - src/server.ts:1263-1265 (registration)Dispatch in call_tool handler: routes 'list_processes' calls to handleListProcesses.
case "list_processes": result = await handlers.handleListProcesses(); break;