# bloopai/vibe-kanban architecture

> Architecture diagram of the GitHub repository bloopai/vibe-kanban, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bloopai/vibe-kanban
- Repository: https://github.com/bloopai/vibe-kanban

## Overview

Vibe Kanban is a kanban-based coding-agent workspace product: engineers plan issues, launch agent workspaces, inspect and preview changes, then create and merge pull requests. The local Rust server and services support workspace execution; web clients expose local and hosted workflows. The README documents the product stages, while sampled sources confirm selected internal calls and integrations. Several listed core modules were not excerpted, so their subsystems are represented without guessed internal call chains.

Main entry points: [`crates/workspace-manager/src/workspace_manager.rs`](https://github.com/bloopai/vibe-kanban/blob/main/crates/workspace-manager/src/workspace_manager.rs) (Workspace management), [`crates/review/src/main.rs`](https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/main.rs) (Review CLI), [`packages/local-web/src/app/entry/App.tsx`](https://github.com/bloopai/vibe-kanban/blob/main/packages/local-web/src/app/entry/App.tsx) (Local web app), [`crates/executors/src/executors/codex/client.rs`](https://github.com/bloopai/vibe-kanban/blob/main/crates/executors/src/executors/codex/client.rs) (Agent executors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Planning and interfaces"]
  node_local_web["Local web app<br/>[App.tsx]"]
  node_remote_web["Remote web app<br/>[App.tsx]"]
  node_issues["Kanban issues<br/>[issues.rs]"]
  node_api_types["API types<br/>[issue.rs]"]
end

subgraph group_execution["Workspace execution"]
  node_server["Local server<br/>[main.rs]"]
  node_workspaces["Workspace management"]
  node_worktrees["Git worktrees"]
  node_executors["Agent executors<br/>[client.rs]"]
  node_codex_rpc["Codex JSON-RPC<br/>[jsonrpc.rs]"]
  node_state[("Workspace state<br/>[session.rs]")]
end

subgraph group_review["Review and delivery"]
  node_diff_review["Diff review<br/>[review.rs]"]
  node_preview["App preview<br/>[lib.rs]"]
  node_pull_requests["Pull requests<br/>[pr.rs]"]
  node_review_cli["Review CLI<br/>[main.rs]"]
  node_review_session["Agent session selection"]
  node_review_archive["Review archive<br/>[archive.rs]"]
  node_review_api["Review service API<br/>[api.rs]"]
end

subgraph group_connectivity["Cloud and connectivity"]
  node_remote_api["Remote API client<br/>[remote_client.rs]"]
  node_auth["Remote authentication<br/>[auth.rs]"]
  node_webrtc["WebRTC connection<br/>[connection.ts]"]
  node_webrtc_manager["Connection manager"]
  node_ssh_handler["Embedded SSH<br/>[handler.rs]"]
  node_sftp["SFTP subsystem<br/>[sftp.rs]"]
  node_desktop_bridge["Editor SSH setup<br/>[service.rs]"]
  node_ssh_config["SSH configuration<br/>[ssh_config.rs]"]
end

node_engineer(("Engineer"))
node_github(("GitHub"))
node_agent_provider(("Coding agent"))

node_engineer -->|"plans work"| node_local_web
node_local_web -->|"manages issues"| node_issues
node_engineer -.->|"uses hosted app"| node_remote_web
node_issues -.->|"uses issue types"| node_api_types
node_local_web -.->|"uses local backend"| node_server
node_server -.->|"creates workspaces"| node_workspaces
node_workspaces -.->|"provides branches"| node_worktrees
node_workspaces -.->|"runs agents"| node_executors
node_executors -->|"dispatches work"| node_agent_provider
node_executors -->|"uses protocol"| node_codex_rpc
node_workspaces -.->|"persists sessions"| node_state
node_engineer -->|"reviews diffs"| node_diff_review
node_engineer -->|"previews app"| node_preview
node_engineer -->|"creates pull requests"| node_pull_requests
node_pull_requests -->|"opens and merges"| node_github
node_engineer -->|"starts review"| node_review_cli
node_review_cli -->|"selects sessions"| node_review_session
node_review_cli -.->|"archives repository"| node_review_archive
node_review_cli -.->|"starts review"| node_review_api
node_remote_api -->|"uses credentials"| node_auth
node_webrtc_manager -->|"creates connection"| node_webrtc
node_ssh_handler -->|"handles SFTP"| node_sftp
node_desktop_bridge -->|"provisions SSH"| node_ssh_config

click node_local_web "https://github.com/bloopai/vibe-kanban/blob/main/packages/local-web/src/app/entry/App.tsx"
click node_remote_web "https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/app/entry/App.tsx"
click node_issues "https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/remote/issues.rs"
click node_api_types "https://github.com/bloopai/vibe-kanban/blob/main/crates/api-types/src/issue.rs"
click node_server "https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/main.rs"
click node_workspaces "https://github.com/bloopai/vibe-kanban/blob/main/crates/workspace-manager/src/workspace_manager.rs"
click node_worktrees "https://github.com/bloopai/vibe-kanban/blob/main/crates/worktree-manager/src/worktree_manager.rs"
click node_executors "https://github.com/bloopai/vibe-kanban/blob/main/crates/executors/src/executors/codex/client.rs"
click node_codex_rpc "https://github.com/bloopai/vibe-kanban/blob/main/crates/executors/src/executors/codex/jsonrpc.rs"
click node_state "https://github.com/bloopai/vibe-kanban/blob/main/crates/db/src/models/session.rs"
click node_diff_review "https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/sessions/review.rs"
click node_preview "https://github.com/bloopai/vibe-kanban/blob/main/crates/preview-proxy/src/lib.rs"
click node_pull_requests "https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/workspaces/pr.rs"
click node_review_cli "https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/main.rs"
click node_review_session "https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/session_selector.rs"
click node_review_archive "https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/archive.rs"
click node_review_api "https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/api.rs"
click node_remote_api "https://github.com/bloopai/vibe-kanban/blob/main/crates/services/src/services/remote_client.rs"
click node_auth "https://github.com/bloopai/vibe-kanban/blob/main/crates/services/src/services/auth.rs"
click node_webrtc "https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/shared/lib/webrtc/connection.ts"
click node_webrtc_manager "https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/shared/lib/webrtc/connectionManager.ts"
click node_ssh_handler "https://github.com/bloopai/vibe-kanban/blob/main/crates/embedded-ssh/src/handler.rs"
click node_sftp "https://github.com/bloopai/vibe-kanban/blob/main/crates/embedded-ssh/src/sftp.rs"
click node_desktop_bridge "https://github.com/bloopai/vibe-kanban/blob/main/crates/desktop-bridge/src/service.rs"
click node_ssh_config "https://github.com/bloopai/vibe-kanban/blob/main/crates/desktop-bridge/src/ssh_config.rs"

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_local_web,node_remote_web,node_issues,node_api_types toneBlue
class node_server,node_workspaces,node_worktrees,node_executors,node_codex_rpc,node_state toneAmber
class node_diff_review,node_preview,node_pull_requests,node_review_cli,node_review_session,node_review_archive,node_review_api toneMint
class node_remote_api,node_auth,node_webrtc,node_webrtc_manager,node_ssh_handler,node_sftp,node_desktop_bridge,node_ssh_config toneRose
class node_engineer,node_github,node_agent_provider toneIndigo
```

## Components

### Planning and interfaces

- [Local web app](https://github.com/bloopai/vibe-kanban/blob/main/packages/local-web/src/app/entry/App.tsx): `packages/local-web/src/app/entry/App.tsx`
- [Remote web app](https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/app/entry/App.tsx): `packages/remote-web/src/app/entry/App.tsx`
- [Kanban issues](https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/remote/issues.rs): `crates/server/src/routes/remote/issues.rs`
- [API types](https://github.com/bloopai/vibe-kanban/blob/main/crates/api-types/src/issue.rs): `crates/api-types/src/issue.rs`

### Workspace execution

- [Local server](https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/main.rs): `crates/server/src/main.rs`
- [Workspace management](https://github.com/bloopai/vibe-kanban/blob/main/crates/workspace-manager/src/workspace_manager.rs): `crates/workspace-manager/src/workspace_manager.rs`
- [Git worktrees](https://github.com/bloopai/vibe-kanban/blob/main/crates/worktree-manager/src/worktree_manager.rs): `crates/worktree-manager/src/worktree_manager.rs`
- [Agent executors](https://github.com/bloopai/vibe-kanban/blob/main/crates/executors/src/executors/codex/client.rs): `crates/executors/src/executors/codex/client.rs`
- [Codex JSON-RPC](https://github.com/bloopai/vibe-kanban/blob/main/crates/executors/src/executors/codex/jsonrpc.rs): `crates/executors/src/executors/codex/jsonrpc.rs`
- [Workspace state](https://github.com/bloopai/vibe-kanban/blob/main/crates/db/src/models/session.rs): `crates/db/src/models/session.rs`

### Review and delivery

- [Diff review](https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/sessions/review.rs): `crates/server/src/routes/sessions/review.rs`
- [App preview](https://github.com/bloopai/vibe-kanban/blob/main/crates/preview-proxy/src/lib.rs): `crates/preview-proxy/src/lib.rs`
- [Pull requests](https://github.com/bloopai/vibe-kanban/blob/main/crates/server/src/routes/workspaces/pr.rs): `crates/server/src/routes/workspaces/pr.rs`
- [Review CLI](https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/main.rs): `crates/review/src/main.rs`
- [Agent session selection](https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/session_selector.rs): `crates/review/src/session_selector.rs`
- [Review archive](https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/archive.rs): `crates/review/src/archive.rs`
- [Review service API](https://github.com/bloopai/vibe-kanban/blob/main/crates/review/src/api.rs): `crates/review/src/api.rs`

### Cloud and connectivity

- [Remote API client](https://github.com/bloopai/vibe-kanban/blob/main/crates/services/src/services/remote_client.rs): `crates/services/src/services/remote_client.rs`
- [Remote authentication](https://github.com/bloopai/vibe-kanban/blob/main/crates/services/src/services/auth.rs): `crates/services/src/services/auth.rs`
- [WebRTC connection](https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/shared/lib/webrtc/connection.ts): `packages/remote-web/src/shared/lib/webrtc/connection.ts`
- [Connection manager](https://github.com/bloopai/vibe-kanban/blob/main/packages/remote-web/src/shared/lib/webrtc/connectionManager.ts): `packages/remote-web/src/shared/lib/webrtc/connectionManager.ts`
- [Embedded SSH](https://github.com/bloopai/vibe-kanban/blob/main/crates/embedded-ssh/src/handler.rs): `crates/embedded-ssh/src/handler.rs`
- [SFTP subsystem](https://github.com/bloopai/vibe-kanban/blob/main/crates/embedded-ssh/src/sftp.rs): `crates/embedded-ssh/src/sftp.rs`
- [Editor SSH setup](https://github.com/bloopai/vibe-kanban/blob/main/crates/desktop-bridge/src/service.rs): `crates/desktop-bridge/src/service.rs`
- [SSH configuration](https://github.com/bloopai/vibe-kanban/blob/main/crates/desktop-bridge/src/ssh_config.rs): `crates/desktop-bridge/src/ssh_config.rs`

### Other components

- **Engineer**
- **GitHub**
- **Coding agent**

## Connections

- Engineer → Local web app: plans work (evidence: `README.md`)
- Local web app → Kanban issues: manages issues (evidence: `README.md`)
- Engineer → Remote web app: uses hosted app (evidence: `README.md`)
- Kanban issues → API types: uses issue types (evidence: `README.md`)
- Local web app → Local server: uses local backend (evidence: `README.md`)
- Local server → Workspace management: creates workspaces (evidence: `README.md`)
- Workspace management → Git worktrees: provides branches (evidence: `README.md`)
- Workspace management → Agent executors: runs agents (evidence: `README.md`)
- Agent executors → Coding agent: dispatches work (evidence: `README.md`)
- Agent executors → Codex JSON-RPC: uses protocol (evidence: `crates/executors/src/executors/codex/client.rs`)
- Workspace management → Workspace state: persists sessions
- Engineer → Diff review: reviews diffs (evidence: `README.md`)
- Engineer → App preview: previews app (evidence: `README.md`)
- Engineer → Pull requests: creates pull requests (evidence: `README.md`)
- Pull requests → GitHub: opens and merges (evidence: `README.md`)
- Engineer → Review CLI: starts review (evidence: `crates/review/src/main.rs`)
- Review CLI → Agent session selection: selects sessions (evidence: `crates/review/src/main.rs`)
- Review CLI → Review archive: archives repository (evidence: `crates/review/src/main.rs`)
- Review CLI → Review service API: starts review (evidence: `crates/review/src/main.rs`)
- Remote API client → Remote authentication: uses credentials (evidence: `crates/services/src/services/remote_client.rs`)
- Connection manager → WebRTC connection: creates connection (evidence: `packages/remote-web/src/shared/lib/webrtc/connectionManager.ts`)
- Embedded SSH → SFTP subsystem: handles SFTP (evidence: `crates/embedded-ssh/src/handler.rs`)
- Editor SSH setup → SSH configuration: provisions SSH (evidence: `crates/desktop-bridge/src/service.rs`)
