How virecorenlm/pi-ai-coder works
PI-AI-CODER is a local coding assistant with CLI and full-screen TUI front ends. Its primary workflow takes a user task, builds project context, sends it to a local model, optionally runs a bounded tool-use loop for code inspection and changes, then presents the result while retaining conversation state. The README also documents model switching, git and shell tools, approval for risky actions, and a workspace UI. Some provider wiring and TUI details are unsampled, so those relationships are omitted or marked unverified.
Main entry points: app.py TUI workspace · tools.py Tool registry · service.py Agent loop · assistant_service.py Assistant service
Components 22
User interfaces
- CLI assistant
assistant.py - TUI workspace
pi_ai_coder/tui/app.py - Workspace widgets
pi_ai_coder/tui/widgets - TUI screens
pi_ai_coder/tui/screens
Assistant workflow
- Assistant service
pi_ai_coder/core/assistant_service.py - Agent loop
pi_ai_coder/agent/service.py - Model runtime
model_runner.py - Local model backends
model_runner.py
Agent and tools
- Tool-call protocol
pi_ai_coder/agent/protocol.py - Tool registry
pi_ai_coder/agent/tools.py - Risk approvals
pi_ai_coder/agent/permissions.py - File operations
pi_ai_coder/tools/files.py - Code search
pi_ai_coder/tools/search.py - Git inspection
pi_ai_coder/tools/git.py - Shell execution
pi_ai_coder/tools/shell.py
Project context and state
- Context selection
pi_ai_coder/context/manager.py - Session persistence
pi_ai_coder/core/session.py - Project workspace
pi_ai_coder/core/project.py - Runtime configuration
pi_ai_coder/config.py
Other components
- Developer
- Ollama server
- llama.cpp runtime
Connections 27
- Developer → CLI assistant: submits task
README.md - Developer → TUI workspace: submits task
README.md - CLI assistant → Assistant service: delegates chat
assistant.py - CLI assistant → Agent loop: starts agent
assistant.py - TUI workspace → Assistant service: uses service
pi_ai_coder/tui/app.py - TUI workspace → Agent loop: runs tasks
pi_ai_coder/tui/app.py - TUI workspace → Workspace widgets: renders workspace
pi_ai_coder/tui/app.py - TUI workspace → TUI screens: opens screens
pi_ai_coder/tui/app.py - Assistant service → Context selection: builds context
pi_ai_coder/core/assistant_service.py - Assistant service → Session persistence: updates session
pi_ai_coder/core/assistant_service.py - Assistant service → Model runtime: requests response
pi_ai_coder/core/assistant_service.py - Agent loop → Model runtime: streams turns
pi_ai_coder/agent/service.py - Model runtime → Local model backends: selects backend
model_runner.py - Local model backends → Ollama server: connects optionally
README.md - Local model backends → llama.cpp runtime: runs optionally
README.md - Agent loop → Tool-call protocol: parses calls
pi_ai_coder/agent/service.py - Agent loop → Tool registry: dispatches tools
pi_ai_coder/agent/service.py - Agent loop → Session persistence: records turns
pi_ai_coder/agent/service.py - Tool registry → Risk approvals: checks risk
pi_ai_coder/agent/tools.py - Tool registry → File operations: dispatches file work
pi_ai_coder/agent/tools.py - Tool registry → Code search: dispatches search
pi_ai_coder/agent/tools.py - Tool registry → Git inspection: dispatches git reads
pi_ai_coder/agent/tools.py - Tool registry → Shell execution: runs commands
pi_ai_coder/agent/tools.py - Workspace widgets → Context selection: views context
pi_ai_coder/tui/widgets/context_panel.py - Workspace widgets → Git inspection: reads git status
pi_ai_coder/tui/widgets/git_panel.py - TUI workspace → Project workspace: opens project
pi_ai_coder/tui/app.py - TUI workspace → Runtime configuration: loads settings
pi_ai_coder/tui/app.py