wikis / Pi Agent / wiki / concepts / coding-agent-overview.md view as markdown report a mistake

The Coding Agent

@earendil-works/pi-coding-agent is Pi's ready-to-use interactive coding agent — "a minimal terminal coding harness" you adapt to your workflow rather than the reverse.

Design stance

• Minimal core, extend with TypeScript — don't fork pi; add extensions and install pi packages.
• Powerful defaults, but intentionally omits sub-agents and plan mode out of the box — you build them or install third-party packages. This keeps the core small and unopinionated.
• Local-first — runs with your user account's permissions in your project (security).

Four run modes

1. Interactive — the TUI coding session (usage).
2. Print / JSON — one-shot non-interactive run, plain or structured JSON output (scripting/CI).
3. RPC — long-lived process integration over a JSON-RPC-style protocol (integration-modes).
4. SDK — embed pi's agent in your own app (this is how OpenClaw embeds pi).

State on disk

Settings, credentials, sessions, and installed pi packages live under ~/.pi/agent/ (project-local config under .pi/). Uninstalling pi leaves these in place.

Getting going

Install and first session: quickstart-and-usage. Pick models/providers in models-and-providers. Sessions, forking, sharing: sessions. The team encourages sharing OSS coding sessions publicly to improve models/prompts/tools.