# ash-blanc/omnigent architecture

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

- Interactive diagram: https://gitdiagram.com/ash-blanc/omnigent
- Repository: https://github.com/ash-blanc/omnigent

## Overview

Omnigent is a multi-agent meta-harness: users create or join sessions through a client, the server routes work to a runner, and the runner executes configured agent harnesses with tools, model access, policies, and sandbox controls. Sessions and collaboration are exposed across terminal, browser, phone, and desktop clients. The graph includes documented capabilities whose implementation was not sampled; edges for those branches cite the README rather than implying source inspection.

Main entry points: [`omnigent/runner`](https://github.com/ash-blanc/omnigent/tree/main/omnigent/runner) (Runner workflow), [`omnigent/server/app.py`](https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/app.py) (API server), [`omnigent/server/routes/sessions/routes_core.py`](https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/routes/sessions/routes_core.py) (Session routes), [`web/src/App.tsx`](https://github.com/ash-blanc/omnigent/blob/main/web/src/App.tsx) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web["Web interface<br/>[App.tsx]"]
  node_terminal["CLI and terminal<br/>[cli.py]"]
  node_vscode["VS Code panel"]
  node_mobile["Phone clients"]
  node_slack["Slack integration<br/>[app.py]"]
end

subgraph group_sessions["Sessions and routing"]
  node_server["API server<br/>[app.py]"]
  node_session_routes["Session routes<br/>[routes_core.py]"]
  node_runner["Runner workflow"]
  node_host["Host and runner routing"]
end

subgraph group_execution["Agent execution"]
  node_harnesses["Agent harnesses"]
  node_process_manager["Harness processes<br/>[process_manager.py]"]
  node_sandbox["Sandbox and egress<br/>[sandbox.py]"]
end

subgraph group_governance["Policies and tools"]
  node_tools["Tool registry<br/>[manager.py]"]
  node_mcp["MCP services<br/>[mcp_manager.py]"]
  node_policy_engine["Policy engine<br/>[engine.py]"]
end

subgraph group_services["Models and storage"]
  node_onboarding["Setup and providers"]
  node_llm["Model clients<br/>[client.py]"]
  node_db[("Session data<br/>[db_models.py]")]
end

node_user(("User"))
node_external_models(("Model providers"))
node_sandbox_providers(("Cloud sandbox providers"))

node_user -->|"uses"| node_web
node_user -->|"uses"| node_terminal
node_user -->|"uses"| node_vscode
node_user -->|"uses"| node_mobile
node_user -.->|"collaborates through"| node_slack
node_web -->|"requests sessions"| node_server
node_terminal -->|"creates sessions"| node_server
node_vscode -->|"opens panel"| node_web
node_mobile -->|"connects to"| node_server
node_slack -.->|"integrates with"| node_server
node_server -->|"routes requests"| node_session_routes
node_session_routes -.->|"reads and writes"| node_db
node_session_routes -->|"launches runner"| node_host
node_host -.->|"routes work"| node_runner
node_runner -->|"starts harnesses"| node_process_manager
node_process_manager -->|"spawns harness"| node_harnesses
node_runner -.->|"dispatches tools"| node_tools
node_runner -.->|"enforces policies"| node_policy_engine
node_runner -.->|"uses MCP tools"| node_mcp
node_runner -.->|"isolates execution"| node_sandbox
node_onboarding -.->|"configures"| node_sandbox_providers
node_sandbox -.->|"runs in"| node_sandbox_providers
node_onboarding -.->|"configures"| node_external_models
node_llm -.->|"calls"| node_external_models
node_runner -.->|"requests completions"| node_llm
node_server -.->|"persists session data"| node_db

click node_web "https://github.com/ash-blanc/omnigent/blob/main/web/src/App.tsx"
click node_terminal "https://github.com/ash-blanc/omnigent/blob/main/omnigent/cli.py"
click node_vscode "https://github.com/ash-blanc/omnigent/blob/main/editors/vscode/src/panel/EditorPanelController.ts"
click node_mobile "https://github.com/ash-blanc/omnigent/blob/main/web/android/app/src/main/java/ai/omnigent/android/OidcLoginManager.kt"
click node_server "https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/app.py"
click node_session_routes "https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/routes/sessions/routes_core.py"
click node_runner "https://github.com/ash-blanc/omnigent/tree/main/omnigent/runner"
click node_host "https://github.com/ash-blanc/omnigent/tree/main/omnigent/host"
click node_harnesses "https://github.com/ash-blanc/omnigent/tree/main/omnigent/harnesses"
click node_process_manager "https://github.com/ash-blanc/omnigent/blob/main/omnigent/runtime/harnesses/process_manager.py"
click node_sandbox "https://github.com/ash-blanc/omnigent/blob/main/omnigent/inner/sandbox.py"
click node_tools "https://github.com/ash-blanc/omnigent/blob/main/omnigent/tools/manager.py"
click node_mcp "https://github.com/ash-blanc/omnigent/blob/main/omnigent/runner/mcp_manager.py"
click node_policy_engine "https://github.com/ash-blanc/omnigent/blob/main/omnigent/runtime/policies/engine.py"
click node_onboarding "https://github.com/ash-blanc/omnigent/tree/main/omnigent/onboarding"
click node_llm "https://github.com/ash-blanc/omnigent/blob/main/omnigent/llms/client.py"
click node_db "https://github.com/ash-blanc/omnigent/blob/main/omnigent/db/db_models.py"
click node_slack "https://github.com/ash-blanc/omnigent/blob/main/integrations/slack/src/omnigent_slack/app.py"

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_web,node_terminal,node_vscode,node_mobile,node_slack,node_user toneBlue
class node_server,node_session_routes,node_runner,node_host toneAmber
class node_harnesses,node_process_manager,node_sandbox toneMint
class node_tools,node_mcp,node_policy_engine toneRose
class node_onboarding,node_llm,node_db,node_external_models,node_sandbox_providers toneIndigo
```

## Components

### User clients

- [Web interface](https://github.com/ash-blanc/omnigent/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [CLI and terminal](https://github.com/ash-blanc/omnigent/blob/main/omnigent/cli.py): `omnigent/cli.py`
- [VS Code panel](https://github.com/ash-blanc/omnigent/blob/main/editors/vscode/src/panel/EditorPanelController.ts): `editors/vscode/src/panel/EditorPanelController.ts`
- [Phone clients](https://github.com/ash-blanc/omnigent/blob/main/web/android/app/src/main/java/ai/omnigent/android/OidcLoginManager.kt): `web/android/app/src/main/java/ai/omnigent/android/OidcLoginManager.kt`
- [Slack integration](https://github.com/ash-blanc/omnigent/blob/main/integrations/slack/src/omnigent_slack/app.py): `integrations/slack/src/omnigent_slack/app.py`

### Sessions and routing

- [API server](https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/app.py): `omnigent/server/app.py`
- [Session routes](https://github.com/ash-blanc/omnigent/blob/main/omnigent/server/routes/sessions/routes_core.py): `omnigent/server/routes/sessions/routes_core.py`
- [Runner workflow](https://github.com/ash-blanc/omnigent/tree/main/omnigent/runner): `omnigent/runner`
- [Host and runner routing](https://github.com/ash-blanc/omnigent/tree/main/omnigent/host): `omnigent/host`

### Agent execution

- [Agent harnesses](https://github.com/ash-blanc/omnigent/tree/main/omnigent/harnesses): `omnigent/harnesses`
- [Harness processes](https://github.com/ash-blanc/omnigent/blob/main/omnigent/runtime/harnesses/process_manager.py): `omnigent/runtime/harnesses/process_manager.py`
- [Sandbox and egress](https://github.com/ash-blanc/omnigent/blob/main/omnigent/inner/sandbox.py): `omnigent/inner/sandbox.py`

### Policies and tools

- [Tool registry](https://github.com/ash-blanc/omnigent/blob/main/omnigent/tools/manager.py): `omnigent/tools/manager.py`
- [MCP services](https://github.com/ash-blanc/omnigent/blob/main/omnigent/runner/mcp_manager.py): `omnigent/runner/mcp_manager.py`
- [Policy engine](https://github.com/ash-blanc/omnigent/blob/main/omnigent/runtime/policies/engine.py): `omnigent/runtime/policies/engine.py`

### Models and storage

- [Setup and providers](https://github.com/ash-blanc/omnigent/tree/main/omnigent/onboarding): `omnigent/onboarding`
- [Model clients](https://github.com/ash-blanc/omnigent/blob/main/omnigent/llms/client.py): `omnigent/llms/client.py`
- [Session data](https://github.com/ash-blanc/omnigent/blob/main/omnigent/db/db_models.py): `omnigent/db/db_models.py`

### Other components

- **User**
- **Model providers**
- **Cloud sandbox providers**

## Connections

- User → Web interface: uses (evidence: `README.md`)
- User → CLI and terminal: uses (evidence: `README.md`)
- User → VS Code panel: uses (evidence: `README.md`)
- User → Phone clients: uses (evidence: `README.md`)
- User → Slack integration: collaborates through (evidence: `README.md`)
- Web interface → API server: requests sessions (evidence: `README.md`)
- CLI and terminal → API server: creates sessions (evidence: `README.md`)
- VS Code panel → Web interface: opens panel (evidence: `editors/vscode/src/panel/EditorPanelController.ts`)
- Phone clients → API server: connects to (evidence: `README.md`)
- Slack integration → API server: integrates with (evidence: `README.md`)
- API server → Session routes: routes requests (evidence: `omnigent/server/app.py`)
- Session routes → Session data: reads and writes
- Session routes → Host and runner routing: launches runner (evidence: `omnigent/server/routes/sessions/routes_core.py`)
- Host and runner routing → Runner workflow: routes work (evidence: `README.md`)
- Runner workflow → Harness processes: starts harnesses (evidence: `omnigent/runtime/harnesses/process_manager.py`)
- Harness processes → Agent harnesses: spawns harness (evidence: `omnigent/runtime/harnesses/process_manager.py`)
- Runner workflow → Tool registry: dispatches tools (evidence: `README.md`)
- Runner workflow → Policy engine: enforces policies (evidence: `README.md`)
- Runner workflow → MCP services: uses MCP tools (evidence: `omnigent/runner/mcp_manager.py`)
- Runner workflow → Sandbox and egress: isolates execution (evidence: `README.md`)
- Setup and providers → Cloud sandbox providers: configures (evidence: `README.md`)
- Sandbox and egress → Cloud sandbox providers: runs in (evidence: `README.md`)
- Setup and providers → Model providers: configures (evidence: `README.md`)
- Model clients → Model providers: calls (evidence: `README.md`)
- Runner workflow → Model clients: requests completions (evidence: `README.md`)
- API server → Session data: persists session data (evidence: `README.md`)
