# omnirush-ai/omnirush-gui architecture

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

- Interactive diagram: https://gitdiagram.com/omnirush-ai/omnirush-gui
- Repository: https://github.com/omnirush-ai/omnirush-gui

## Overview

OmniRush is a desktop coding-agent app. The main workflow is a user composing a task in a project session, selecting a model, and receiving an agent response and tool-produced changes, subject to tool approvals. The app also manages provider and MCP connections, skills, artifacts, and workspace sessions; a local server hosts the engine, whose plugin layer adapts agent tools and extensions. README capability descriptions establish several workflow links; sampled code confirms selected engine, desktop, and plugin responsibilities, but not all UI-to-runtime wiring.

Main entry points: [`apps/app/src/react-app/domains/session/chat/session-page.tsx`](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/chat/session-page.tsx) (Project session), [`apps/app/src/react-app/domains/session/surface/composer/composer.tsx`](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/surface/composer/composer.tsx) (Task composer), [`apps/server/src/engine-pool.ts`](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/engine-pool.ts) (Engine pool), [`apps/server/src/opencode-plugins/omnirush-engine2.ts`](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/opencode-plugins/omnirush-engine2.ts) (Engine plugins)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_session["Session workspace"]
  node_session_ui["Project session<br/>[session-page.tsx]"]
  node_composer["Task composer<br/>[composer.tsx]"]
  node_approval["Tool approvals"]
  node_chat_view["Conversation view<br/>[message-list.tsx]"]
  node_artifacts["Artifact workspace<br/>[artifact-panel.tsx]"]
end

subgraph group_engine["Agent runtime"]
  node_engine_pool["Engine pool<br/>[engine-pool.ts]"]
  node_engine_plugin["Engine plugins"]
  node_engine_shapes["Tool shapes<br/>[shapes.ts]"]
end

subgraph group_connections["Models and tools"]
  node_model_picker["Model selection"]
  node_provider_auth["Provider connections"]
  node_mcp_connections["MCP connections<br/>[add-mcp-modal.tsx]"]
  node_built_tools["Agent tools<br/>[build-in-tools.ts]"]
end

subgraph group_desktop["Desktop services"]
  node_desktop_main["Desktop host<br/>[main.mjs]"]
  node_workspace_store[("Workspace state<br/>[main.mjs]")]
end

subgraph group_cloud["Cloud management"]
  node_cloud_auth["Cloud sign-in"]
  node_plugin_routes["Plugin management<br/>[routes.ts]"]
end

node_user(("User"))
node_user_model{{"Model provider"}}
node_mcp_service{{"MCP server"}}
node_project[("Project files")]

node_user -->|"writes task"| node_composer
node_composer -->|"submits task"| node_session_ui
node_session_ui -.->|"runs agent"| node_engine_pool
node_model_picker -->|"selects model"| node_session_ui
node_provider_auth -->|"configures access"| node_user_model
node_engine_pool -.->|"hosts plugins"| node_engine_plugin
node_engine_plugin -->|"adapts tools"| node_engine_shapes
node_engine_plugin -.->|"dispatches tools"| node_built_tools
node_built_tools -->|"changes files"| node_project
node_composer -->|"sets permissions"| node_approval
node_engine_pool -.->|"returns responses"| node_chat_view
node_chat_view -.->|"opens artifacts"| node_artifacts
node_session_ui -.->|"uses workspace"| node_workspace_store
node_desktop_main -->|"manages workspace"| node_workspace_store
node_mcp_connections -->|"connects tools"| node_mcp_service
node_cloud_auth -.->|"manages plugins"| node_plugin_routes
node_plugin_routes -.->|"configures MCP"| node_mcp_connections

click node_session_ui "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/chat/session-page.tsx"
click node_composer "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/surface/composer/composer.tsx"
click node_approval "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/chat/permission-approval-modal.tsx"
click node_chat_view "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/components/chat/message-list.tsx"
click node_artifacts "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/artifacts/artifact-panel.tsx"
click node_engine_pool "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/engine-pool.ts"
click node_engine_plugin "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/opencode-plugins/omnirush-engine2.ts"
click node_engine_shapes "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/engine2/shapes.ts"
click node_model_picker "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/modals/model-picker-modal.tsx"
click node_provider_auth "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/connections/provider-auth/provider-auth-modal.tsx"
click node_mcp_connections "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/connections/modals/add-mcp-modal.tsx"
click node_built_tools "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/lib/build-in-tools.ts"
click node_desktop_main "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/desktop/electron/main.mjs"
click node_workspace_store "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/desktop/electron/main.mjs"
click node_cloud_auth "https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/cloud/den-auth-provider.tsx"
click node_plugin_routes "https://github.com/omnirush-ai/omnirush-gui/blob/main/ee/apps/den-api/src/routes/org/plugin-system/routes.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_session_ui,node_composer,node_approval,node_chat_view,node_artifacts,node_user toneBlue
class node_engine_pool,node_engine_plugin,node_engine_shapes,node_project toneAmber
class node_model_picker,node_provider_auth,node_mcp_connections,node_built_tools,node_mcp_service toneMint
class node_desktop_main,node_workspace_store toneRose
class node_cloud_auth,node_plugin_routes,node_user_model toneIndigo
```

## Components

### Session workspace

- [Project session](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/chat/session-page.tsx): `apps/app/src/react-app/domains/session/chat/session-page.tsx`
- [Task composer](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/surface/composer/composer.tsx): `apps/app/src/react-app/domains/session/surface/composer/composer.tsx`
- [Tool approvals](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/chat/permission-approval-modal.tsx): `apps/app/src/react-app/domains/session/chat/permission-approval-modal.tsx`
- [Conversation view](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/components/chat/message-list.tsx): `apps/app/src/components/chat/message-list.tsx`
- [Artifact workspace](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/artifacts/artifact-panel.tsx): `apps/app/src/react-app/domains/session/artifacts/artifact-panel.tsx`

### Agent runtime

- [Engine pool](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/engine-pool.ts): `apps/server/src/engine-pool.ts`
- [Engine plugins](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/opencode-plugins/omnirush-engine2.ts): `apps/server/src/opencode-plugins/omnirush-engine2.ts`
- [Tool shapes](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/server/src/engine2/shapes.ts): `apps/server/src/engine2/shapes.ts`

### Models and tools

- [Model selection](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/session/modals/model-picker-modal.tsx): `apps/app/src/react-app/domains/session/modals/model-picker-modal.tsx`
- [Provider connections](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/connections/provider-auth/provider-auth-modal.tsx): `apps/app/src/react-app/domains/connections/provider-auth/provider-auth-modal.tsx`
- [MCP connections](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/connections/modals/add-mcp-modal.tsx): `apps/app/src/react-app/domains/connections/modals/add-mcp-modal.tsx`
- [Agent tools](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/lib/build-in-tools.ts): `apps/app/src/lib/build-in-tools.ts`

### Desktop services

- [Desktop host](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/desktop/electron/main.mjs): `apps/desktop/electron/main.mjs`
- [Workspace state](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/desktop/electron/main.mjs): `apps/desktop/electron/main.mjs`

### Cloud management

- [Cloud sign-in](https://github.com/omnirush-ai/omnirush-gui/blob/main/apps/app/src/react-app/domains/cloud/den-auth-provider.tsx): `apps/app/src/react-app/domains/cloud/den-auth-provider.tsx`
- [Plugin management](https://github.com/omnirush-ai/omnirush-gui/blob/main/ee/apps/den-api/src/routes/org/plugin-system/routes.ts): `ee/apps/den-api/src/routes/org/plugin-system/routes.ts`

### Other components

- **User**
- **Model provider**
- **MCP server**
- **Project files**

## Connections

- User → Task composer: writes task
- Task composer → Project session: submits task
- Project session → Engine pool: runs agent
- Model selection → Project session: selects model
- Provider connections → Model provider: configures access
- Engine pool → Engine plugins: hosts plugins
- Engine plugins → Tool shapes: adapts tools (evidence: `apps/server/src/opencode-plugins/omnirush-engine2.ts`)
- Engine plugins → Agent tools: dispatches tools
- Agent tools → Project files: changes files
- Task composer → Tool approvals: sets permissions
- Engine pool → Conversation view: returns responses
- Conversation view → Artifact workspace: opens artifacts
- Project session → Workspace state: uses workspace
- Desktop host → Workspace state: manages workspace (evidence: `apps/desktop/electron/main.mjs`)
- MCP connections → MCP server: connects tools
- Cloud sign-in → Plugin management: manages plugins
- Plugin management → MCP connections: configures MCP
