pi Architecture Deep DiveReading the source top-down

An English study site that walks layer by layer through the design of badlogic/pi-mono. Every step links straight to the corresponding source lines on GitHub, pinned at v0.73.1.

Start reading →

pi-ai streaming facade

Agent main loop

GitHub repo

Top-down

Walk from pi-ai's unified LLM API → pi-agentcore's loop → pi-coding-agent CLI → pi-tui terminal UI → pi-web-ui web components, one layer at a time.

Source-level pointers

Every key file ships with a SrcLink that opens the exact lines on GitHub. The version is pinned at v0.73.1, so upgrading only changes one spot.

Real code inlined

Not just pointers — the actual 5-15 lines of TypeScript from key functions are pasted directly into the page, with plain-English notes on what's happening before and after.

Design motivation and edges

Each page covers responsibilities, why the design ended up this way, and how edge cases and failure modes are handled.

Five-package stack

pi-mono is a monorepo: pi-ai (foundation) → pi-agent-core (general agent) → pi-coding-agent (coding CLI) + pi-tui (terminal) + pi-web-ui (web). How the packages fit together.

Reuses official docs

This site focuses on architecture and source location. For install and usage, refer to the official README — we don't duplicate it.