How jonusnattapong/preme-agent works
Preme Agent is a long-running coding and research agent. A user starts it through the CLI, which prepares input, resolves a model, creates a session and launches an execution mode; the agent can use a persistent Python REPL and return results through the terminal interface. Durable sessions, recursive subagents, skills, extensions and MCP integrations are additional product capabilities. The excerpts show key CLI calls, but not most runtime wiring; dashed edges mark those documented or plausible links whose implementation relationship was not shown.
Main entry points: main.ts CLI orchestration · agent-session-runtime.ts Session runtime · interactive-mode.ts Interactive mode · agent-session.ts Agent session
Components 19
Entry and modes
- CLI orchestration
packages/coding-agent/src/main.ts - Interactive mode
packages/coding-agent/src/modes/interactive/interactive-mode.ts - RPC mode
packages/coding-agent/src/modes/rpc/rpc-mode.ts - ACP mode
packages/coding-agent/src/modes/acp/acp-mode.ts - Daemon mode
packages/coding-agent/src/modes/daemon/daemon-mode.ts
Agent runtime
- Agent session
packages/coding-agent/src/core/agent-session.ts - Session runtime
packages/coding-agent/src/core/agent-session-runtime.ts - Agent loop
packages/agent/src/agent-loop.ts - Model resolution
packages/coding-agent/src/core/model-resolver.ts - AI providers
packages/ai/src/providers
Sessions and state
- Durable sessions
packages/coding-agent/src/core/session-manager.ts - Authentication
packages/coding-agent/src/core/auth-storage.ts
Tools and integrations
- Persistent Python REPL
prime-agent-runtime/src/rlm/repl.py - Agent tools
packages/coding-agent/src/core/tools - Skills and extensions
packages/coding-agent/src/core/extensions - MCP integrations
packages/coding-agent/src/core/mcp/mcp-manager.ts
Terminal interface
- Terminal interface
packages/tui/src/tui.ts - Prompt editor
packages/tui/src/components/editor.ts
Other components
- User
Connections 21
- User → CLI orchestration: starts
README.md - CLI orchestration → Model resolution: resolves model
packages/coding-agent/src/main.ts - CLI orchestration → Agent session: creates session
packages/coding-agent/src/main.ts - CLI orchestration → Interactive mode: runs mode
packages/coding-agent/src/main.ts - CLI orchestration → RPC mode: dispatches
- CLI orchestration → ACP mode: dispatches
- CLI orchestration → Daemon mode: dispatches
packages/coding-agent/src/main.ts - Model resolution → AI providers: selects provider
- Agent session → Session runtime: uses runtime
- Session runtime → Agent loop: runs agent
- Agent session → Durable sessions: persists state
- Session runtime → Persistent Python REPL: executes Python
- Session runtime → Agent tools: invokes tools
- Session runtime → Skills and extensions: loads workflows
- Session runtime → MCP integrations: serves host requests
- Interactive mode → Terminal interface: renders interface
- Terminal interface → Prompt editor: hosts editor
packages/tui/src/tui.ts - Interactive mode → Durable sessions: resumes sessions
README.md - Interactive mode → Agent loop: supports subagents
README.md - Session runtime → Durable sessions: compacts branches
README.md - Agent session → Authentication: uses credentials