daemon

Usage

kicad-cruncher daemon
kicad-cruncher daemon --host 127.0.0.1 --port 8765
kicad-cruncher daemon --host 0.0.0.0 --allow-remote-host
kicad-cruncher daemon --health

Arguments

--host defaults to 127.0.0.1. Non-loopback hosts are rejected unless --allow-remote-host is supplied. --port defaults to 8765. --reload enables uvicorn reload for local development. --health prints the shared health payload and exits without starting a server.

Output

The running daemon exposes /health, /version, /api/v1/commands, /api/v1/kicad/session, /api/v1/pcb/layer-cleanup, and the initial browser tool center at /. On startup it writes a local kicad_cruncher.daemon.state.v0 JSON file containing the loopback URL that installed plugins can discover; KICAD_CRUNCHER_DAEMON_STATE overrides the state-file path for tests and custom installs. The tool center uses a Lib Cruncher-style compact tabbed shell with PCB Clean as the first active tab.

Adapters

/api/v1/pcb/layer-cleanup delegates to the shared PCB clean logic. mode=file may perform explicit direct-file apply for automation. mode=kicad-ipc returns a mutation request for the KiCad plugin to apply through KiCad IPC under the editor commit/undo model; the daemon does not mutate live KiCad editor state itself.

Tests

L0 verifies command registration, help, and host policy. L3 exercises startup state writing with an injected server runner, command inventory, plugin daemon-state discovery, plugin-mode PCB clean mutation planning, mocked KiCad IPC apply-adapter behavior, and daemon file-mode apply against public fixtures. L99 verifies package-wide Ruff and Pyright.