# mini-yifan/deepseek-harness-orb architecture

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

- Interactive diagram: https://gitdiagram.com/mini-yifan/deepseek-harness-orb
- Repository: https://github.com/mini-yifan/deepseek-harness-orb

## Overview

DeepSeek Orb is a desktop AI assistant with two distinct task tracks: visible Computer Use in a floating ball and background coding sessions. The main window provides the broader dsh interface for sessions, plugins, and model settings; selection tools and platform services extend the desktop experience. The README establishes the user-facing workflow and capabilities. Source excerpts are limited, so internal links are included only where the index or excerpts show a relationship; other documented product branches are left unconnected where their wiring is not shown.

Main entry points: [`packages/api/session-controller/src/client/sessions/manager.ts`](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/manager.ts) (Background sessions), [`packages/experimental/tool-computer-use/src/route.ts`](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/experimental/tool-computer-use/src/route.ts) (Computer Use), [`apps/desktop/src/floating-window.ts`](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/floating-window.ts) (Floating ball), [`apps/web/src/main.ts`](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/web/src/main.ts) (Main Web UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_desktop["Desktop entry<br/>[main.ts]"]
  node_floating["Floating ball<br/>[floating-window.ts]"]
  node_webui["Main Web UI<br/>[main.ts]"]
  node_ipc["Desktop IPC<br/>[ipc.ts]"]
  node_host["Desktop Host services"]
  node_updates["Update coordinator"]
end

subgraph group_agents["Agent tracks"]
  node_computer["Computer Use<br/>[route.ts]"]
  node_background["Background sessions<br/>[manager.ts]"]
end

subgraph group_sessions["Sessions and settings"]
  node_session["Session lifecycle<br/>[session.ts]"]
  node_sessionservice["Session service<br/>[service.ts]"]
  node_projection["Session projections"]
  node_notifier["Session notifier<br/>[notifier.ts]"]
  node_persistence[("Session persistence<br/>[storage.ts]")]
  node_plugins["Plugin manager UI"]
  node_models["Subagent model settings"]
end

subgraph group_interaction["Desktop interactions"]
  node_selection["Selection toolbar"]
  node_monitor["Selection monitor"]
  node_observation["Observation window"]
end

node_user(("User"))

node_user -->|"sends task"| node_floating
node_floating -->|"runs foreground"| node_computer
node_computer -.->|"uses desktop tools"| node_host
node_computer -->|"dispatches complex work"| node_background
node_background -->|"returns completion"| node_floating
node_user -->|"opens main window"| node_webui
node_webui -->|"manages plugins"| node_plugins
node_webui -->|"configures models"| node_models
node_background -->|"manages instances"| node_session
node_background -->|"uses service"| node_sessionservice
node_background -->|"loads projections"| node_projection
node_projection -->|"marks dirty"| node_notifier
node_session -.->|"stores history"| node_persistence
node_user -->|"selects text"| node_selection
node_selection -->|"starts monitor"| node_monitor
node_selection -->|"prompts overlay"| node_floating
node_desktop -.->|"configures IPC"| node_ipc
node_desktop -.->|"coordinates updates"| node_updates
node_computer -.->|"observes screen"| node_observation

click node_desktop "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/main.ts"
click node_floating "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/floating-window.ts"
click node_webui "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/web/src/main.ts"
click node_ipc "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/ipc.ts"
click node_host "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop-host/src/desktop-plugin-services.ts"
click node_computer "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/experimental/tool-computer-use/src/route.ts"
click node_background "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/manager.ts"
click node_session "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/session.ts"
click node_sessionservice "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/service.ts"
click node_projection "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/projection-store.ts"
click node_notifier "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/notifier.ts"
click node_persistence "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/session/session-persistence-jsonl/src/storage.ts"
click node_plugins "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx"
click node_models "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/client/ui-settings-subagent/src/client/subagent-model-selection-card-controller.ts"
click node_selection "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/selection-toolbar-controller.ts"
click node_monitor "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/selection-monitor.ts"
click node_observation "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/observation-frame-window.ts"
click node_updates "https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/update-coordinator.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_desktop,node_floating,node_webui,node_ipc,node_host,node_updates,node_user toneBlue
class node_computer,node_background toneAmber
class node_session,node_sessionservice,node_projection,node_notifier,node_persistence,node_plugins,node_models toneMint
class node_selection,node_monitor,node_observation toneRose
```

## Components

### Desktop shell

- [Desktop entry](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/main.ts): `apps/desktop/src/main.ts`
- [Floating ball](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/floating-window.ts): `apps/desktop/src/floating-window.ts`
- [Main Web UI](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/web/src/main.ts): `apps/web/src/main.ts`
- [Desktop IPC](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/ipc.ts): `apps/desktop/src/ipc.ts`
- [Desktop Host services](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop-host/src/desktop-plugin-services.ts): `apps/desktop-host/src/desktop-plugin-services.ts`
- [Update coordinator](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/update-coordinator.ts): `apps/desktop/src/update-coordinator.ts`

### Agent tracks

- [Computer Use](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/experimental/tool-computer-use/src/route.ts): `packages/experimental/tool-computer-use/src/route.ts`
- [Background sessions](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/manager.ts): `packages/api/session-controller/src/client/sessions/manager.ts`

### Sessions and settings

- [Session lifecycle](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/session.ts): `packages/api/session-controller/src/client/sessions/session.ts`
- [Session service](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/service.ts): `packages/api/session-controller/src/client/sessions/service.ts`
- [Session projections](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/projection-store.ts): `packages/api/session-controller/src/client/sessions/projection-store.ts`
- [Session notifier](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/api/session-controller/src/client/sessions/notifier.ts): `packages/api/session-controller/src/client/sessions/notifier.ts`
- [Session persistence](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/session/session-persistence-jsonl/src/storage.ts): `packages/session/session-persistence-jsonl/src/storage.ts`
- [Plugin manager UI](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx): `packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx`
- [Subagent model settings](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/packages/client/ui-settings-subagent/src/client/subagent-model-selection-card-controller.ts): `packages/client/ui-settings-subagent/src/client/subagent-model-selection-card-controller.ts`

### Desktop interactions

- [Selection toolbar](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/selection-toolbar-controller.ts): `apps/desktop/src/selection-toolbar-controller.ts`
- [Selection monitor](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/selection-monitor.ts): `apps/desktop/src/selection-monitor.ts`
- [Observation window](https://github.com/mini-yifan/deepseek-harness-orb/blob/main/apps/desktop/src/observation-frame-window.ts): `apps/desktop/src/observation-frame-window.ts`

### Other components

- **User**

## Connections

- User → Floating ball: sends task (evidence: `README.md`)
- Floating ball → Computer Use: runs foreground (evidence: `README.md`)
- Computer Use → Desktop Host services: uses desktop tools
- Computer Use → Background sessions: dispatches complex work (evidence: `README.md`)
- Background sessions → Floating ball: returns completion (evidence: `README.md`)
- User → Main Web UI: opens main window (evidence: `README.md`)
- Main Web UI → Plugin manager UI: manages plugins (evidence: `README.md`)
- Main Web UI → Subagent model settings: configures models (evidence: `README.md`)
- Background sessions → Session lifecycle: manages instances (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Background sessions → Session service: uses service (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Background sessions → Session projections: loads projections (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Session projections → Session notifier: marks dirty (evidence: `packages/api/session-controller/src/client/sessions/projection-store.ts`)
- Session lifecycle → Session persistence: stores history
- User → Selection toolbar: selects text (evidence: `README.md`)
- Selection toolbar → Selection monitor: starts monitor (evidence: `apps/desktop/src/selection-toolbar-controller.ts`)
- Selection toolbar → Floating ball: prompts overlay (evidence: `apps/desktop/src/selection-toolbar-controller.ts`)
- Desktop entry → Desktop IPC: configures IPC
- Desktop entry → Update coordinator: coordinates updates
- Computer Use → Observation window: observes screen
