How colin781/mini-pi works
Mini Pi is a terminal coding agent: a user submits a repository task, the agent consults a model and workspace tools, applies guarded edits, runs verification, and presents a report. The REPL adds chat/task routing, persistent sessions, context reuse, and change review; configuration selects providers and runtime behavior. Separate evaluation tooling runs reproducible tasks and checks results. The graph preserves README-documented capabilities whose implementation was not sampled, but omits uncertain internal links where excerpts do not establish a call.
Main entry points: agent.py Coding agent loop · tools.py Tool executor · repl.py Interactive REPL · cli.py CLI
Components 24
Entry and interaction
- CLI
mini_pi/cli.py - Interactive REPL
mini_pi/repl.py - Configuration
mini_pi/config.py
Agent runtime
- Coding agent loop
agent.py - Model backend
mini_pi/model_backend.py - Lightweight chat
mini_pi/chat.py - Context budgeting
mini_pi/context.py
Workspace operations
- Tool executor
mini_pi/tools.py - Repository index
mini_pi/repository.py - Patch application
mini_pi/patching.py - Command policy
mini_pi/command_policy.py - Path protection
mini_pi/protection.py - File checkpoints
mini_pi/checkpoints.py - Task verification
mini_pi/verification.py
State and results
- Session persistence
mini_pi/sessions.py - Conversation handling
mini_pi/conversation.py - Change tracking
mini_pi/change_tracking.py - Run reports
mini_pi/reporting.py - Run tracing
mini_pi/tracing.py - Terminal presentation
mini_pi/terminal_ui.py
Evaluation
- Evaluation runner
mini_pi/evaluation.py - Evaluation CLI
mini_pi/eval_cli.py
Other components
- User
- Ollama / DeepSeek
Connections 28
- User → CLI: starts task
- CLI → Configuration: loads settings
mini_pi/cli.py - CLI → Interactive REPL: starts REPL
mini_pi/cli.py - CLI → Coding agent loop: runs task
mini_pi/cli.py - Interactive REPL → Coding agent loop: dispatches tasks
mini_pi/repl.py - Interactive REPL → Lightweight chat: routes chat
mini_pi/repl.py - Interactive REPL → Session persistence: persists sessions
mini_pi/repl.py - Interactive REPL → Conversation handling: reuses context
mini_pi/repl.py - Interactive REPL → Model backend: selects provider
mini_pi/repl.py - Coding agent loop → Model backend: requests completions
agent.py - Model backend → Ollama / DeepSeek: sends requests
- Coding agent loop → Context budgeting: budgets context
agent.py - Coding agent loop → Tool executor: executes tool calls
agent.py - Tool executor → Repository index: indexes workspace
mini_pi/tools.py - Tool executor → Patch application: applies patches
mini_pi/tools.py - Tool executor → Command policy: checks commands
mini_pi/tools.py - Tool executor → Path protection: checks paths
mini_pi/tools.py - Tool executor → File checkpoints: creates checkpoints
mini_pi/tools.py - Tool executor → Change tracking: tracks edits
mini_pi/tools.py - Coding agent loop → Task verification: runs acceptance
agent.py - Coding agent loop → File checkpoints: restores attempts
agent.py - Coding agent loop → Run reports: builds report
agent.py - Coding agent loop → Run tracing: records events
agent.py - Coding agent loop → Terminal presentation: presents result
agent.py - Evaluation CLI → Evaluation runner: runs evaluations
mini_pi/eval_cli.py - Evaluation runner → Coding agent loop: launches agent
mini_pi/evaluation.py - Evaluation runner → Task verification: checks outcomes
mini_pi/evaluation.py - Evaluation runner → Run reports: reads run reports
mini_pi/evaluation.py