How ash-blanc/omnigent works
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: runner Runner workflow · app.py API server · routes_core.py Session routes · App.tsx Web interface
Components 21
User clients
- Web interface
web/src/App.tsx - CLI and terminal
omnigent/cli.py - VS Code panel
editors/vscode/src/panel/EditorPanelController.ts - Phone clients
web/android/app/src/main/java/ai/omnigent/android/OidcLoginManager.kt - Slack integration
integrations/slack/src/omnigent_slack/app.py
Sessions and routing
- API server
omnigent/server/app.py - Session routes
omnigent/server/routes/sessions/routes_core.py - Runner workflow
omnigent/runner - Host and runner routing
omnigent/host
Agent execution
- Agent harnesses
omnigent/harnesses - Harness processes
omnigent/runtime/harnesses/process_manager.py - Sandbox and egress
omnigent/inner/sandbox.py
Policies and tools
- Tool registry
omnigent/tools/manager.py - MCP services
omnigent/runner/mcp_manager.py - Policy engine
omnigent/runtime/policies/engine.py
Models and storage
- Setup and providers
omnigent/onboarding - Model clients
omnigent/llms/client.py - Session data
omnigent/db/db_models.py
Other components
- User
- Model providers
- Cloud sandbox providers
Connections 26
- User → Web interface: uses
README.md - User → CLI and terminal: uses
README.md - User → VS Code panel: uses
README.md - User → Phone clients: uses
README.md - User → Slack integration: collaborates through
README.md - Web interface → API server: requests sessions
README.md - CLI and terminal → API server: creates sessions
README.md - VS Code panel → Web interface: opens panel
editors/vscode/src/panel/EditorPanelController.ts - Phone clients → API server: connects to
README.md - Slack integration → API server: integrates with
README.md - API server → Session routes: routes requests
omnigent/server/app.py - Session routes → Session data: reads and writes
- Session routes → Host and runner routing: launches runner
omnigent/server/routes/sessions/routes_core.py - Host and runner routing → Runner workflow: routes work
README.md - Runner workflow → Harness processes: starts harnesses
omnigent/runtime/harnesses/process_manager.py - Harness processes → Agent harnesses: spawns harness
omnigent/runtime/harnesses/process_manager.py - Runner workflow → Tool registry: dispatches tools
README.md - Runner workflow → Policy engine: enforces policies
README.md - Runner workflow → MCP services: uses MCP tools
omnigent/runner/mcp_manager.py - Runner workflow → Sandbox and egress: isolates execution
README.md - Setup and providers → Cloud sandbox providers: configures
README.md - Sandbox and egress → Cloud sandbox providers: runs in
README.md - Setup and providers → Model providers: configures
README.md - Model clients → Model providers: calls
README.md - Runner workflow → Model clients: requests completions
README.md - API server → Session data: persists session data
README.md