pi-agent
| Version | 2026.199.1330 |
| Repo | superproject |
Ephemeral native Pi agent runtime. Pins @earendil-works/pi-coding-agent
and pi-tui 0.80.10 and installs a thin runner built on
createAgentSessionRuntime, SessionManager, and Pi’s own
runRpcMode JSONL transport. It has no service, listener, supervisor, or
boot-time process; one runner exists only for an active Charly run.
When the separately installed official Pi orchestrator CLI is present,
the runner delegates orchestrated streams to that CLI without copying
or translating its protocol.
It also installs a pi-tui controller that renders durable Charly
sessions/events and invokes only the typed charly agent API.
Acceptance plan
Section titled “Acceptance plan”This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.
| Intent | Step |
|---|---|
run |
prepare the official Pi SessionManager store for an unprivileged named-volume mount |
run |
install the native Pi runtime entrypoint |
run |
install the Pi-TUI controller for the headless Charly API |
run |
expose the native Pi runtime and controller on the npm user PATH |
check |
the pinned official Pi coding-agent and TUI packages are installed |
check |
the ephemeral native Pi runner is installed and executable |
check |
the Pi-TUI controller is installed and executable |
check |
the native Pi runtime is exposed on PATH |
check |
the Pi-TUI controller is exposed on PATH |