API Reference

kernel

Python kernel server.

Runs as a standalone Unix socket server. Must be started explicitly before Claude Code can use it. Persists across Claude Code sessions.

Usage:

python kernel.py <name> # start a named kernel python kernel.py # start with default name “default”

Socket path: /tmp/python-kernel-<name>.sock

kernel.handle(conn, name)

kernel.kernel_exec(code: str) → None

kernel.run_script(code: str)

kernel.serve(name: str)

kernel.socket_path(name: str) → str

main

MCP server exposing a Python kernel to Claude Code. The kernel must be started separately with: python kernel.py <name>

main.connect_kernel(name: str) → tuple[str, bool]

main.error(id, code, message)

main.handle(req)

main.kernel_call(name: str, cmd: str, code: str = '') → tuple[str, bool]

main.kernel_vars_text(name: str) → str

main.list_kernels() → tuple[str, bool]

main.main()

main.respond(id, result)

main.socket_path(name: str) → str

main.spawn_kernel(name: str, python: str) → tuple[str, bool]

tui

TUI for inspecting running Python kernels.

python tui.py

Navigation:

j/k or arrow keys move selection enter select / drill in q / esc go back / quit r refresh

tui.draw_hint_bar(win, text: str)

tui.draw_list(win, items: list[str], sel: int, title: str)

tui.draw_vars(win, name: str, variables: dict[str, str] | str, sel: int)

tui.fill_bg(win)

tui.init_colors()

tui.kernel_vars(name: str) → dict[str, str] | str

tui.list_kernels() → list[str]

tui.main()

tui.run(stdscr)

tui.socket_path(name: str) → str