How bparafina/pi_agent_rust works
Pi Agent Rust is a native terminal coding agent. Its principal workflow takes a user prompt through the CLI and application runtime, uses a model/provider to generate streamed responses and tool calls, and presents results in the terminal while maintaining sessions. The README also documents extension execution and security, MCP servers, package management, and browser/computer capabilities. Some major source modules named in the SOURCE INDEX are absent from the supplied tree; those areas are represented only where an exact enclosing path is available, and unsampled implementation details are not inferred.
Main entry points: app.rs Agent runtime · mod.rs Provider backends · models.rs Model catalog · client.rs Streaming HTTP
Components 18
Agent runtime
- CLI entry
src/app.rs - Agent runtime
src/app.rs - Configuration
src/config.rs - Messages and events
src/model.rs
Models and providers
- Model catalog
src/models.rs - Provider interface
src/provider.rs - Provider backends
src/providers/mod.rs - Streaming HTTP
src/http/client.rs
Tools and extensions
- Built-in tools
src - Extension runtime
src/extensions/extension_manager_impl.rs - Package management
src/package_manager.rs
Integrations and state
- MCP servers
src/mcp/manager.rs - Session persistence
src - Language server
src/lsp/client.rs - Browser automation
src/browser/cdp.rs
Other components
- User
- Model services
- Terminal
Connections 18
- User → CLI entry: provides prompt
README.md - CLI entry → Agent runtime: starts workflow
src/app.rs - Agent runtime → Configuration: loads settings
src/app.rs - Agent runtime → Model catalog: selects model
src/app.rs - Model catalog → Provider interface: defines routing
src/models.rs - Provider backends → Provider interface: implements
src/providers/mod.rs - Provider backends → Streaming HTTP: sends requests
src/providers/mod.rs - Streaming HTTP → Model services: streams API traffic
- Provider backends → Messages and events: emits events
src/providers/mod.rs - Agent runtime → Messages and events: processes turns
src/app.rs - Agent runtime → Built-in tools: dispatches tools
README.md - Agent runtime → Session persistence: persists session
README.md - Agent runtime → Terminal: renders results
README.md - Extension runtime → Built-in tools: exposes hostcalls
README.md - Package management → Extension runtime: installs packages
README.md - Agent runtime → MCP servers: uses servers
README.md - Agent runtime → Language server: uses language services
README.md - Agent runtime → Browser automation: uses browser tools
README.md