Generated by Code IQ · v1.0

pi-mono
Knowledge Tutorial

A chapter-by-chapter walkthrough of pi-mono, generated from its source code and tutorial markdown.

7
Chapters
-
Subsystems
∞
Rabbit Holes
▶ Start Reading ⎇ View on GitHub
System Architecture

How the pieces fit

pi-mono is organized as connected concepts and components. Start broad, then drill down chapter by chapter.

👥
Agent Session
Agent Session
👥
Agent Runtime
Agent Runtime
⚙️
Unified AI Interface
Unified AI Interface
🔧
Standard Tools
Standard Tools
⚙️
TUI Engine
TUI Engine
⚙️
Context Compaction
Context Compaction
⚙️
Extension System
Extension System
pi-mono — bash
➜open tutorial
◆ Scanning numbered chapters
◆ Building navigation and Mermaid diagrams
◆ Generating chapter and subsystem pages
✓ 7 chapter pages built
✓ Theme toggle enabled
➜
Repository Overview

Intro and Architecture Diagram

pi-mono is an advanced AI coding assistant built on a modular architecture. At its core, an Agent Runtime manages the thought loop, while an Agent Session handles long-term memory and persistence. It features a robust TUI Engine for a flicker-free terminal interface, a Context Compaction system to manage token limits by summarizing history, and a flexible Extension System to dynamically add new commands and capabilities.

Source Repository: https://github.com/badlogic/pi-mono

flowchart TD A0["Agent Runtime"] A1["Unified AI Interface"] A2["Agent Session"] A3["TUI Engine"] A4["Context Compaction"] A5["Extension System"] A6["Standard Tools"] A2 -->|"Manages lifecycle"| A0 A0 -->|"Streams responses"| A1 A2 -->|"Emits events to"| A5 A5 -->|"Controls UI widgets"| A3 A2 -->|"Prunes history"| A4 A4 -->|"Summarizes context"| A1 A2 -->|"Registers capabilities"| A6
Tutorial Chapters

All 7 chapters

Follow sequentially or jump to any topic. Start with Agent Session.

Ch.01 AGENTS
Agent Session
Welcome to the pi-mono project tutorial! We are kicking things off with the most fundamental building block for creating a persistent, inte…
↗
Ch.02 AGENTS
Agent Runtime
Welcome to the second chapter of the pi-mono tutorial!
↗
Ch.03 CORE
Unified AI Interface
In the previous Agent Runtime chapter, we built the "brain" that can think in loops and execute tasks. However, that brain needs a raw sour…
↗
Ch.04 TOOLS
Standard Tools
Welcome to Chapter 4 of the pi-mono tutorial!
↗
Ch.05 CORE
TUI Engine
Welcome to Chapter 5 of the pi-mono tutorial!
↗
Ch.06 CORE
Context Compaction
Welcome to Chapter 6 of the pi-mono tutorial!
↗
Ch.07 CORE
Extension System
Welcome to Chapter 7 of the pi-mono tutorial!
↗
About This Project

Generated by Code IQ

This tutorial was automatically generated by Code IQ and rendered with the shared tutorial site builder. It can be produced for any repository tutorial folder that follows the numbered markdown chapter layout.

View Code IQ ↗
python build_site.py '/home/runner/work/Code-IQ/Code-IQ/output/pi-mono'

// → 7 chapters
// → source: badlogic/pi-mono