# dicklesworthstone/pi_agent_rust architecture

> Architecture diagram of the GitHub repository dicklesworthstone/pi_agent_rust, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dicklesworthstone/pi_agent_rust
- Repository: https://github.com/dicklesworthstone/pi_agent_rust

## Overview

pi_agent_rust is a native terminal AI coding agent. The main workflow starts with a user prompt or resumed session, configures a model and credentials, runs an agent turn that can call coding tools, then streams and persists the result. The product also documents extension security, MCP servers, multi-agent work, planning, LSP, browser/computer control, and multiple interaction modes. Relationships below use README statements and SOURCE INDEX references; unsampled subsystems are represented only where their paths and capabilities are documented.

Main entry points: [`src/agent.rs`](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/agent.rs) (Agent loop), [`src/app.rs`](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/app.rs) (Application entry), [`src/interactive/ext_session.rs`](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/interactive/ext_session.rs) (Interactive mode), [`src/provider.rs`](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/provider.rs) (Provider interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_app["Application entry<br/>[app.rs]"]
  node_interactive["Interactive mode<br/>[ext_session.rs]"]
  node_rpc["RPC mode<br/>[rpc-mode.ts]"]
end

subgraph group_agent["Agent runtime"]
  node_agentloop["Agent loop<br/>[agent.rs]"]
  node_context["Capability context<br/>[agent_cx.rs]"]
  node_compaction["Context compaction"]
  node_planning["Plan sessions<br/>[session.rs]"]
  node_subagents["Subagent execution<br/>[execution.rs]"]
end

subgraph group_models["Models and providers"]
  node_config["Configuration<br/>[config.rs]"]
  node_auth["Authentication<br/>[auth.rs]"]
  node_catalog["Model registry<br/>[models.rs]"]
  node_provider["Provider interface<br/>[provider.rs]"]
  node_backends["Provider backends<br/>[mod.rs]"]
  node_http["Streaming HTTP<br/>[client.rs]"]
end

subgraph group_tools["Tools and integrations"]
  node_tools["Coding tools<br/>[tools.rs]"]
  node_extensions["Extensions"]
  node_mcp["MCP servers<br/>[manager.rs]"]
  node_lsp["Language server<br/>[client.rs]"]
  node_browser["Browser control<br/>[cdp.rs]"]
end

subgraph group_state["Sessions and state"]
  node_sessions[("Session persistence<br/>[session.rs]")]
  node_memory[("Agent memory<br/>[shared.rs]")]
end

node_user(("CLI user"))
node_externalmodel(("Model service"))

node_user -->|"prompts"| node_app
node_app -->|"loads settings"| node_config
node_app -->|"selects models"| node_catalog
node_app -->|"uses credentials"| node_auth
node_app -.->|"starts agent"| node_agentloop
node_app -.->|"offers interaction"| node_interactive
node_interactive -->|"resumes sessions"| node_sessions
node_agentloop -->|"uses capabilities"| node_context
node_agentloop -->|"requests completions"| node_provider
node_provider -->|"implemented by"| node_backends
node_backends -->|"streams requests"| node_http
node_http -.->|"sends requests"| node_externalmodel
node_agentloop -->|"invokes tools"| node_tools
node_agentloop -->|"persists messages"| node_sessions
node_agentloop -.->|"compacts context"| node_compaction
node_agentloop -->|"supports planning"| node_planning
node_agentloop -->|"runs subagents"| node_subagents
node_agentloop -->|"loads extensions"| node_extensions
node_extensions -->|"gates tool calls"| node_tools
node_agentloop -->|"uses MCP tools"| node_mcp
node_agentloop -.->|"supports code intelligence"| node_lsp
node_agentloop -.->|"supports browser control"| node_browser
node_agentloop -.->|"uses shared memory"| node_memory
node_app -.->|"offers RPC mode"| node_rpc

click node_app "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/app.rs"
click node_interactive "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/interactive/ext_session.rs"
click node_rpc "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/legacy_pi_mono_code/pi-mono/packages/coding-agent/src/modes/rpc/rpc-mode.ts"
click node_agentloop "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/agent.rs"
click node_context "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/agent_cx.rs"
click node_compaction "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/compaction_worker.rs"
click node_planning "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/plan/session.rs"
click node_subagents "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/subagents/execution.rs"
click node_config "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/config.rs"
click node_auth "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/auth.rs"
click node_catalog "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/models.rs"
click node_provider "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/provider.rs"
click node_backends "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/providers/mod.rs"
click node_http "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/http/client.rs"
click node_tools "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/tools.rs"
click node_extensions "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/extensions/extension_manager_impl.rs"
click node_mcp "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/mcp/manager.rs"
click node_lsp "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/lsp/client.rs"
click node_browser "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/browser/cdp.rs"
click node_sessions "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/session.rs"
click node_memory "https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/memory/shared.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_interactive,node_rpc,node_user toneBlue
class node_agentloop,node_context,node_compaction,node_planning,node_subagents toneAmber
class node_config,node_auth,node_catalog,node_provider,node_backends,node_http toneMint
class node_tools,node_extensions,node_mcp,node_lsp,node_browser toneRose
class node_sessions,node_memory,node_externalmodel toneIndigo
```

## Components

### User interaction

- [Application entry](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/app.rs): `src/app.rs`
- [Interactive mode](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/interactive/ext_session.rs): `src/interactive/ext_session.rs`
- [RPC mode](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/legacy_pi_mono_code/pi-mono/packages/coding-agent/src/modes/rpc/rpc-mode.ts): `legacy_pi_mono_code/pi-mono/packages/coding-agent/src/modes/rpc/rpc-mode.ts`

### Agent runtime

- [Agent loop](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/agent.rs): `src/agent.rs`
- [Capability context](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/agent_cx.rs): `src/agent_cx.rs`
- [Context compaction](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/compaction_worker.rs): `src/compaction_worker.rs`
- [Plan sessions](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/plan/session.rs): `src/plan/session.rs`
- [Subagent execution](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/subagents/execution.rs): `src/subagents/execution.rs`

### Models and providers

- [Configuration](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/config.rs): `src/config.rs`
- [Authentication](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/auth.rs): `src/auth.rs`
- [Model registry](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/models.rs): `src/models.rs`
- [Provider interface](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/provider.rs): `src/provider.rs`
- [Provider backends](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/providers/mod.rs): `src/providers/mod.rs`
- [Streaming HTTP](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/http/client.rs): `src/http/client.rs`

### Tools and integrations

- [Coding tools](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/tools.rs): `src/tools.rs`
- [Extensions](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/extensions/extension_manager_impl.rs): `src/extensions/extension_manager_impl.rs`
- [MCP servers](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/mcp/manager.rs): `src/mcp/manager.rs`
- [Language server](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/lsp/client.rs): `src/lsp/client.rs`
- [Browser control](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/browser/cdp.rs): `src/browser/cdp.rs`

### Sessions and state

- [Session persistence](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/session.rs): `src/session.rs`
- [Agent memory](https://github.com/dicklesworthstone/pi_agent_rust/blob/main/src/memory/shared.rs): `src/memory/shared.rs`

### Other components

- **CLI user**
- **Model service**

## Connections

- CLI user → Application entry: prompts (evidence: `README.md`)
- Application entry → Configuration: loads settings (evidence: `src/app.rs`)
- Application entry → Model registry: selects models (evidence: `src/app.rs`)
- Application entry → Authentication: uses credentials (evidence: `src/app.rs`)
- Application entry → Agent loop: starts agent
- Application entry → Interactive mode: offers interaction
- Interactive mode → Session persistence: resumes sessions (evidence: `src/interactive/ext_session.rs`)
- Agent loop → Capability context: uses capabilities (evidence: `src/agent_cx.rs`)
- Agent loop → Provider interface: requests completions (evidence: `src/provider.rs`)
- Provider interface → Provider backends: implemented by (evidence: `src/providers/mod.rs`)
- Provider backends → Streaming HTTP: streams requests (evidence: `src/providers/mod.rs`)
- Streaming HTTP → Model service: sends requests
- Agent loop → Coding tools: invokes tools
- Agent loop → Session persistence: persists messages
- Agent loop → Context compaction: compacts context
- Agent loop → Plan sessions: supports planning (evidence: `README.md`)
- Agent loop → Subagent execution: runs subagents (evidence: `README.md`)
- Agent loop → Extensions: loads extensions (evidence: `README.md`)
- Extensions → Coding tools: gates tool calls (evidence: `README.md`)
- Agent loop → MCP servers: uses MCP tools (evidence: `README.md`)
- Agent loop → Language server: supports code intelligence
- Agent loop → Browser control: supports browser control
- Agent loop → Agent memory: uses shared memory
- Application entry → RPC mode: offers RPC mode
