How primeintellect-ai/prime-agent works
Prime Agent is a coding and research agent designed for persistent, long-running work. A user starts through the CLI, which prepares a session and presents an interactive or headless interface; the agent then works through a persistent Python REPL, invokes models and tools, and records session state. Separate capabilities support durable harness refinement, skills, goals, schedules, MCP integrations, and daemon-backed continuity and agent coordination. The README documents these major branches; sampled excerpts establish selected entry-point, kernel, session-storage, daemon-client, and MCP details, so uncertain internal wiring is omitted.
Main entry points: agent-session.ts Agent Session · main.ts CLI Entry · interactive-mode.ts Interactive TUI · rlm-runtime.ts RLM Runtime
Components 22
User Interfaces
- CLI Entry
packages/coding-agent/src/main.ts - Interactive TUI
packages/coding-agent/src/modes/interactive/interactive-mode.ts - Headless Modes
packages/coding-agent/src/modes/index.ts
Agent Runtime
- Agent Session
packages/coding-agent/src/core/agent-session.ts - RLM Runtime
packages/coding-agent/src/core/rlm-runtime.ts - Python Kernel
packages/coding-agent/src/core/kernel/repl-manager.ts - Agent Tools
packages/coding-agent/src/core/tools/index.ts - Context Compaction
packages/coding-agent/src/core/compaction/compaction.ts - Session Files
packages/coding-agent/src/core/session-manager.ts
Harness State
- Harness Refinement
packages/coding-agent/src/core/refinement/refinement.ts - Executable Skills
packages/coding-agent/src/core/skills.ts - Goals And Schedules
packages/coding-agent/src/core/goals.ts
Long-Running Agents
- Daemon Service
packages/coding-agent/src/modes/daemon/daemon-mode.ts - Session Worker
packages/coding-agent/src/cli/owned-session-worker.ts - Agent Connections
packages/coding-agent/src/modes/agent-connection/index.ts
Models And Tools
- Model Registry
packages/coding-agent/src/core/model-registry.ts - Provider Clients
packages/ai/src/index.ts - MCP Manager
packages/coding-agent/src/core/mcp/mcp-manager.ts
Other components
- User
- Model Provider
- Project Files
- MCP Services
Connections 24
- User → CLI Entry: starts
- CLI Entry → Agent Session: creates session
- CLI Entry → Interactive TUI: runs interface
- CLI Entry → Headless Modes: dispatches mode
- Interactive TUI → Agent Session: sends prompts
- Headless Modes → Agent Session: runs session
- Agent Session → RLM Runtime: runs agent
- RLM Runtime → Python Kernel: executes code
- Python Kernel → Agent Tools: invokes tools
- Agent Tools → Project Files: reads and edits
- Agent Session → Model Registry: resolves model
- Model Registry → Provider Clients: selects provider
- Provider Clients → Model Provider: requests inference
- Agent Session → Session Files: persists transcript
- Agent Session → Context Compaction: compacts context
- Agent Session → Harness Refinement: refines state
- RLM Runtime → Executable Skills: imports skills
- Agent Session → Goals And Schedules: tracks objectives
- Daemon Service → Session Worker: owns worker
- Session Worker → Agent Session: runs session
- Interactive TUI → Daemon Service: connects over socket
- Agent Connections → Daemon Service: coordinates agents
- Agent Session → MCP Manager: serves host requests
- MCP Manager → MCP Services: connects services