$ cat ~/map/pi.md

pi

The Pi monorepo: unified LLM API, agent loop, TUI, and the coding agent CLI itself.

officialtools✓ Oct 16

Facts

repository: github.com/earendil-works/pi ↗
GitHub Stars: ★ 115.5K
Forks: 14.7K
license: MIT
npm / mo: —
last push: Oct 15, 2026

install

npm install -g @earendil-works/pi-coding-agent

## TL;DR

The Pi Agent Harness monorepo: the self-extensible coding agent CLI, the agent runtime, a unified multi-provider LLM API, a TUI library, and telemetry contracts — everything else on this map builds on it.

## Key points

$Five published packages: @earendil-works/pi-coding-agent (interactive CLI), pi-agent-core (agent runtime with tool calling and state), pi-ai (unified LLM API across OpenAI, Anthropic, Google and more), pi-tui (terminal UI with differential rendering), and pi-telemetry.
$Pi has no built-in permission system — it runs with the permissions of the launching user. The docs describe three containerization patterns for stronger boundaries: the Gondolin extension (micro-VM tool routing), plain Docker, and OpenShell policy sandboxes.
$Supply-chain hardening is a first-class concern: direct dependencies pinned to exact versions, an npm shrinkwrap in the published CLI, lifecycle-script allowlists, and release smoke tests with isolated installs.
$New issues and PRs from new contributors are auto-closed by default; maintainers review the auto-closed queue daily (see CONTRIBUTING.md).
$The maintainers publicly share real OSS agent sessions (via pi-share-hf to Hugging Face) to give the ecosystem real-world training and evaluation data.

## FAQ

Q How do I install the coding agent?

The CLI ships as the npm package @earendil-works/pi-coding-agent: npm install -g @earendil-works/pi-coding-agent, then run pi. pi update --self updates it in place.

Q Does Pi sandbox tool execution?

No. Pi intentionally ships no built-in permission system and runs with your user's permissions. If you need boundaries, the containerization docs cover Gondolin (route tools into a micro-VM while keeping auth on the host), plain Docker, and OpenShell.

Q Where do the longer-term design plans live?

The RFCs are published at rfc.earendil.com (keyword pi), and project rules for both humans and agents are in AGENTS.md at the repo root.

## References

## Related entries

## Guides

Last updated: Aug 31, 2026