status
Check VICE C64 emulator connection and emulation state to verify connectivity, monitor running/paused status, and confirm host/port details before executing debugging commands.
Instructions
Get current VICE connection and emulation state.
Returns connection status, whether emulation is running or paused, and host/port if connected.
Use this to:
Check if you're connected before running other commands
See if emulation is running or stopped (e.g., at a breakpoint)
Verify connection details
Related tools: connect, disconnect
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:82-112 (registration)Registration of the 'status' tool using server.registerTool. Includes detailed description and an inline async handler function that retrieves the current VICE client state using client.getState() and formats the response with connection status, running state, host/port, and a contextual hint.server.registerTool( "status", { description: `Get current VICE connection and emulation state. Returns connection status, whether emulation is running or paused, and host/port if connected. Use this to: - Check if you're connected before running other commands - See if emulation is running or stopped (e.g., at a breakpoint) - Verify connection details Related tools: connect, disconnect`, }, async () => { const state = client.getState(); return formatResponse({ connected: state.connected, running: state.running, ...(state.connected && { host: state.host, port: state.port, }), hint: state.connected ? state.running ? "VICE is running. Use setBreakpoint() + continue() to pause at a specific point, or step() to execute one instruction." : "VICE is paused. Use continue() to resume or step() to execute one instruction." : "Not connected. Use connect() to establish connection to VICE.", }); } );
- src/index.ts:96-111 (handler)Inline handler function for the 'status' tool. Fetches the emulation state from the VICE client and returns a formatted response including connection details and execution status hint.async () => { const state = client.getState(); return formatResponse({ connected: state.connected, running: state.running, ...(state.connected && { host: state.host, port: state.port, }), hint: state.connected ? state.running ? "VICE is running. Use setBreakpoint() + continue() to pause at a specific point, or step() to execute one instruction." : "VICE is paused. Use continue() to resume or step() to execute one instruction." : "Not connected. Use connect() to establish connection to VICE.", }); }
- src/index.ts:26-47 (helper)formatResponse helper function used by 'status' (and other tools) to standardize tool responses with JSON-formatted content including _meta section with connection and running state.function formatResponse(data: object) { const state = client.getState(); return { content: [ { type: "text" as const, text: JSON.stringify( { ...data, _meta: { connected: state.connected, running: state.running, ...(state.connected && { host: state.host, port: state.port }), }, }, null, 2 ), }, ], }; }