$ cat ~/map/pi-docs.md
Pi documentation (pi.dev)
The official Pi site and documentation — installation, configuration, extensions, and themes.
officialtutorials
Facts
- repository
- pi.dev/ ↗
- GitHub Stars
- —
- Forks
- —
- license
- —
- npm / mo
- —
- last push
- —
## TL;DR
The official pi documentation at pi.dev — versioned docs for the minimal terminal coding harness, from quickstart, providers, sessions, and settings through extensions, skills, themes, packages, and programmatic SDK/RPC usage.
## Key points
- $Canonical documentation for pi, described as a minimal terminal coding harness that stays small at the core while being extended through TypeScript extensions, skills, prompt templates, themes, and pi packages.
- $Start-here track: Quickstart, Using Pi (slash commands, context files, CLI), Providers, llama.cpp, Security, Containerization, Settings, Keybindings, Sessions, and Compaction.
- $Customization track covers Extensions, Skills, Prompt templates, Themes, Pi packages, Custom models, and Custom providers; programmatic usage documents the Node.js SDK, RPC mode over stdin/stdout JSONL, JSON event stream mode, and TUI components.
- $Reference and platform sections: environment variables, the JSONL session format, Windows, Termux on Android, tmux, terminal setup, and shell aliases — plus a Development section for local setup, project structure, and debugging.
- $Every topic deep-links under /docs/latest/ (for example /docs/latest/quickstart, /docs/latest/extensions, /docs/latest/sessions); the docs are versioned, and each page links back to its source in the earendil-works/pi repository for viewing or editing.
## FAQ
Q Where should a new user start?
Begin with /docs/latest/quickstart — install, authenticate via /login or an API key, and try the four default tools — then Using Pi for slash commands, context files, and the CLI. The Providers page explains subscription and API-key login for each built-in provider.
Q Does the documentation cover programmatic use?
Yes. The SDK section covers embedding pi in Node.js applications, and there are dedicated sections for RPC mode (stdin/stdout JSONL), the JSON event stream mode, and reusable TUI components.
## References
## Related entries
$ I tried Pi after watching its founder explain why he quit Claude Code
A hands-on dev.to write-up of trying Pi after hearing its founder's case against Claude Code.
$ learn-pi-agent
A chapter-by-chapter rebuild of Pi's agent harness, from one LLM call to a working coding agent.
$ pi-bluebook (Pi 学习蓝皮书)
Free unofficial Chinese-language learning path that takes Pi beginners from first install to skills, extensions, and long-running workflows.
Last updated: Aug 31, 2026