Returns whether the C64 is running or stopped, along with the current stop reason and program counter when available.

Returns emulator session state including transport/process status, auto-resume state, and the most recent hit checkpoint.

Returns the current C64 register snapshot. Requires emulator to be stopped - call execute(action="pause") first if running.

Sets one or more C64 registers by field name. Requires emulator to be stopped - call execute(action="pause") first if running.

Reads a memory chunk. Specify start_address and either data_length or end_address. Address can be decimal (53248) or hex string with prefix ($D000, 0xD000). Returns byte values as decimal numbers.

Writes raw byte values into C64 memory. Address and byte values support decimal, hex ($FF, 0xFF), and binary (%11111111, 0b11111111) formats. Requires emulator to be stopped.

Controls execution with pause, resume, step, step_over, step_out, or reset. Pause and resume are idempotent (safe to call multiple times).

Waits for the emulator to reach a target execution state and optionally remain there for a stability window.

Lists current breakpoints and watchpoints.

Creates an execution breakpoint or read/write watchpoint. Specify start_address and either data_length or end_address. Address can be decimal (53248) or hex string with prefix ($D000, 0xD000).

Deletes a breakpoint by numeric id.

Loads a C64 program and optionally starts it.

Captures the current screen to a PNG file and returns the saved image path.

Returns screen RAM, color RAM, the current graphics mode, screen memory addresses, and the current border and background colors.

Returns the current text screen as readable text when the C64 is in a text mode.

Types text into the C64. Automatically resumes if stopped and restores pause state after. Supports escaped characters and PETSCII brace tokens like {RETURN}, {CLR}, {HOME}, {PI}, and color names. Limit 64 bytes per request.

Sends one to four keys or PETSCII tokens to the C64. Automatically resumes if stopped and restores pause state after. Use for key presses, releases, and taps.

Sends joystick input to C64 joystick port 1 or 2. Automatically resumes if stopped and restores pause state after.