How davidondrej/pi-agent works
Pi Monorepo is a toolkit for building AI agents and managing LLM deployments. Its principal workflow is the coding-agent CLI: users start a run, which resolves configuration and session state before entering the agent runtime. The repository also provides a multi-provider AI API, agent and terminal-UI libraries, a browser chat UI, GPU-pod management, and a Slack bot that delegates work to the coding agent. The graph emphasizes documented package roles and indexed source references; several runtime connections are omitted where sampled code does not establish them.
Main entry points: main.ts Coding CLI · agent-session-services.ts Session Services · agent-session.ts Coding Agent · tui.ts Terminal UI
Components 18
Coding Agent
- Coding CLI
packages/coding-agent/src/main.ts - Configuration
packages/coding-agent/src/config.ts - Session Manager
packages/coding-agent/src/core/session-manager.ts - Agent Session Runtime
packages/coding-agent/src/core/agent-session-runtime.ts - Session Services
packages/coding-agent/src/core/agent-session-services.ts - Coding Tools
packages/coding-agent/src/core/tools - Coding Agent
packages/coding-agent/src/core/agent-session.ts
Agent Platform
- Multi-provider AI API
packages/ai/src/types.ts - Agent Runtime
packages/agent/src/agent-loop.ts
User Interfaces
- Terminal UI
packages/tui/src/tui.ts - Terminal Editor
packages/tui/src/components/editor.ts - Web Chat UI
packages/web-ui/src/ChatPanel.ts - Browser Storage
packages/web-ui/src/storage/app-storage.ts
Deployment
- Pod Management CLI
packages/pods/src/cli.ts - Pod SSH
packages/pods/src/ssh.ts
Slack Bot
- Slack Bot
packages/mom/src/slack.ts - Delegated Agent
packages/mom/src/agent.ts
Other components
- User
Connections 19
- User → Coding CLI: starts run
README.md - Coding CLI → Configuration: resolves settings
packages/coding-agent/src/main.ts - Coding CLI → Session Manager: opens session
packages/coding-agent/src/main.ts - Coding CLI → Agent Session Runtime: creates runtime
packages/coding-agent/src/main.ts - Coding CLI → Session Services: loads services
packages/coding-agent/src/main.ts - Session Services → Configuration: reads config
packages/coding-agent/src/core/agent-session-services.ts - Session Services → Session Manager: uses sessions
packages/coding-agent/src/core/agent-session-services.ts - Session Services → Coding Tools: loads tools
packages/coding-agent/src/core/agent-session-services.ts - User → Terminal UI: uses terminal UI
README.md - Terminal UI → Terminal Editor: hosts editor
packages/tui/src/components/editor.ts - User → Web Chat UI: uses web chat
README.md - Browser Storage → Web Chat UI: stores chat state
- User → Pod Management CLI: manages deployments
README.md - Pod Management CLI → Pod SSH: dispatches SSH
packages/pods/src/cli.ts - User → Slack Bot: messages bot
README.md - Slack Bot → Delegated Agent: routes requests
packages/mom/src/agent.ts - Delegated Agent → Coding Agent: delegates work
README.md - Coding Agent → Agent Runtime: uses agent runtime
- Coding Agent → Multi-provider AI API: uses model API