# jonusnattapong/preme-agent architecture

> Architecture diagram of the GitHub repository jonusnattapong/preme-agent, 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/jonusnattapong/preme-agent
- Repository: https://github.com/jonusnattapong/preme-agent

## Overview

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: [`packages/coding-agent/src/main.ts`](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/main.ts) (CLI orchestration), [`packages/coding-agent/src/core/agent-session-runtime.ts`](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session-runtime.ts) (Session runtime), [`packages/coding-agent/src/modes/interactive/interactive-mode.ts`](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/interactive/interactive-mode.ts) (Interactive mode), [`packages/coding-agent/src/core/agent-session.ts`](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session.ts) (Agent session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and modes"]
  node_cli["CLI orchestration<br/>[main.ts]"]
  node_interactive["Interactive mode"]
  node_rpc["RPC mode<br/>[rpc-mode.ts]"]
  node_acp["ACP mode<br/>[acp-mode.ts]"]
  node_daemon["Daemon mode<br/>[daemon-mode.ts]"]
end

subgraph group_runtime["Agent runtime"]
  node_session["Agent session<br/>[agent-session.ts]"]
  node_session_runtime["Session runtime"]
  node_agent_loop["Agent loop<br/>[agent-loop.ts]"]
  node_models["Model resolution<br/>[model-resolver.ts]"]
  node_ai_providers["AI providers"]
end

subgraph group_state["Sessions and state"]
  node_sessions[("Durable sessions<br/>[session-manager.ts]")]
  node_auth[("Authentication<br/>[auth-storage.ts]")]
end

subgraph group_integrations["Tools and integrations"]
  node_repl["Persistent Python REPL<br/>[repl.py]"]
  node_tools["Agent tools"]
  node_skills_extensions["Skills and extensions"]
  node_mcp["MCP integrations<br/>[mcp-manager.ts]"]
end

subgraph group_interface["Terminal interface"]
  node_tui["Terminal interface<br/>[tui.ts]"]
  node_editor["Prompt editor<br/>[editor.ts]"]
end

node_user(("User"))

node_user -.->|"starts"| node_cli
node_cli -->|"resolves model"| node_models
node_cli -->|"creates session"| node_session
node_cli -->|"runs mode"| node_interactive
node_cli -.->|"dispatches"| node_rpc
node_cli -.->|"dispatches"| node_acp
node_cli -->|"dispatches"| node_daemon
node_models -.->|"selects provider"| node_ai_providers
node_session -.->|"uses runtime"| node_session_runtime
node_session_runtime -.->|"runs agent"| node_agent_loop
node_session -.->|"persists state"| node_sessions
node_session_runtime -.->|"executes Python"| node_repl
node_session_runtime -.->|"invokes tools"| node_tools
node_session_runtime -.->|"loads workflows"| node_skills_extensions
node_session_runtime -.->|"serves host requests"| node_mcp
node_interactive -.->|"renders interface"| node_tui
node_tui -->|"hosts editor"| node_editor
node_interactive -.->|"resumes sessions"| node_sessions
node_interactive -.->|"supports subagents"| node_agent_loop
node_session_runtime -.->|"compacts branches"| node_sessions
node_session -.->|"uses credentials"| node_auth

click node_cli "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/main.ts"
click node_interactive "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/interactive/interactive-mode.ts"
click node_rpc "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/rpc/rpc-mode.ts"
click node_acp "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/acp/acp-mode.ts"
click node_daemon "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/daemon/daemon-mode.ts"
click node_session "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session.ts"
click node_session_runtime "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session-runtime.ts"
click node_agent_loop "https://github.com/jonusnattapong/preme-agent/blob/main/packages/agent/src/agent-loop.ts"
click node_models "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/model-resolver.ts"
click node_ai_providers "https://github.com/jonusnattapong/preme-agent/tree/main/packages/ai/src/providers"
click node_sessions "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/session-manager.ts"
click node_auth "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/auth-storage.ts"
click node_repl "https://github.com/jonusnattapong/preme-agent/blob/main/prime-agent-runtime/src/rlm/repl.py"
click node_tools "https://github.com/jonusnattapong/preme-agent/tree/main/packages/coding-agent/src/core/tools"
click node_skills_extensions "https://github.com/jonusnattapong/preme-agent/tree/main/packages/coding-agent/src/core/extensions"
click node_mcp "https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/mcp/mcp-manager.ts"
click node_tui "https://github.com/jonusnattapong/preme-agent/blob/main/packages/tui/src/tui.ts"
click node_editor "https://github.com/jonusnattapong/preme-agent/blob/main/packages/tui/src/components/editor.ts"

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_cli,node_interactive,node_rpc,node_acp,node_daemon,node_user toneBlue
class node_session,node_session_runtime,node_agent_loop,node_models,node_ai_providers toneAmber
class node_sessions,node_auth toneMint
class node_repl,node_tools,node_skills_extensions,node_mcp toneRose
class node_tui,node_editor toneIndigo
```

## Components

### Entry and modes

- [CLI orchestration](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/main.ts): `packages/coding-agent/src/main.ts`
- [Interactive mode](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/interactive/interactive-mode.ts): `packages/coding-agent/src/modes/interactive/interactive-mode.ts`
- [RPC mode](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/rpc/rpc-mode.ts): `packages/coding-agent/src/modes/rpc/rpc-mode.ts`
- [ACP mode](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/acp/acp-mode.ts): `packages/coding-agent/src/modes/acp/acp-mode.ts`
- [Daemon mode](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/modes/daemon/daemon-mode.ts): `packages/coding-agent/src/modes/daemon/daemon-mode.ts`

### Agent runtime

- [Agent session](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session.ts): `packages/coding-agent/src/core/agent-session.ts`
- [Session runtime](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/agent-session-runtime.ts): `packages/coding-agent/src/core/agent-session-runtime.ts`
- [Agent loop](https://github.com/jonusnattapong/preme-agent/blob/main/packages/agent/src/agent-loop.ts): `packages/agent/src/agent-loop.ts`
- [Model resolution](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/model-resolver.ts): `packages/coding-agent/src/core/model-resolver.ts`
- [AI providers](https://github.com/jonusnattapong/preme-agent/tree/main/packages/ai/src/providers): `packages/ai/src/providers`

### Sessions and state

- [Durable sessions](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/session-manager.ts): `packages/coding-agent/src/core/session-manager.ts`
- [Authentication](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/auth-storage.ts): `packages/coding-agent/src/core/auth-storage.ts`

### Tools and integrations

- [Persistent Python REPL](https://github.com/jonusnattapong/preme-agent/blob/main/prime-agent-runtime/src/rlm/repl.py): `prime-agent-runtime/src/rlm/repl.py`
- [Agent tools](https://github.com/jonusnattapong/preme-agent/tree/main/packages/coding-agent/src/core/tools): `packages/coding-agent/src/core/tools`
- [Skills and extensions](https://github.com/jonusnattapong/preme-agent/tree/main/packages/coding-agent/src/core/extensions): `packages/coding-agent/src/core/extensions`
- [MCP integrations](https://github.com/jonusnattapong/preme-agent/blob/main/packages/coding-agent/src/core/mcp/mcp-manager.ts): `packages/coding-agent/src/core/mcp/mcp-manager.ts`

### Terminal interface

- [Terminal interface](https://github.com/jonusnattapong/preme-agent/blob/main/packages/tui/src/tui.ts): `packages/tui/src/tui.ts`
- [Prompt editor](https://github.com/jonusnattapong/preme-agent/blob/main/packages/tui/src/components/editor.ts): `packages/tui/src/components/editor.ts`

### Other components

- **User**

## Connections

- User → CLI orchestration: starts (evidence: `README.md`)
- CLI orchestration → Model resolution: resolves model (evidence: `packages/coding-agent/src/main.ts`)
- CLI orchestration → Agent session: creates session (evidence: `packages/coding-agent/src/main.ts`)
- CLI orchestration → Interactive mode: runs mode (evidence: `packages/coding-agent/src/main.ts`)
- CLI orchestration → RPC mode: dispatches
- CLI orchestration → ACP mode: dispatches
- CLI orchestration → Daemon mode: dispatches (evidence: `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 (evidence: `packages/tui/src/tui.ts`)
- Interactive mode → Durable sessions: resumes sessions (evidence: `README.md`)
- Interactive mode → Agent loop: supports subagents (evidence: `README.md`)
- Session runtime → Durable sessions: compacts branches (evidence: `README.md`)
- Agent session → Authentication: uses credentials
