How bloopai/vibe-kanban works
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: workspace_manager.rs Workspace management · main.rs Review CLI · App.tsx Local web app · client.rs Agent executors
Components 28
Planning and interfaces
- Local web app
packages/local-web/src/app/entry/App.tsx - Remote web app
packages/remote-web/src/app/entry/App.tsx - Kanban issues
crates/server/src/routes/remote/issues.rs - API types
crates/api-types/src/issue.rs
Workspace execution
- Local server
crates/server/src/main.rs - Workspace management
crates/workspace-manager/src/workspace_manager.rs - Git worktrees
crates/worktree-manager/src/worktree_manager.rs - Agent executors
crates/executors/src/executors/codex/client.rs - Codex JSON-RPC
crates/executors/src/executors/codex/jsonrpc.rs - Workspace state
crates/db/src/models/session.rs
Review and delivery
- Diff review
crates/server/src/routes/sessions/review.rs - App preview
crates/preview-proxy/src/lib.rs - Pull requests
crates/server/src/routes/workspaces/pr.rs - Review CLI
crates/review/src/main.rs - Agent session selection
crates/review/src/session_selector.rs - Review archive
crates/review/src/archive.rs - Review service API
crates/review/src/api.rs
Cloud and connectivity
- Remote API client
crates/services/src/services/remote_client.rs - Remote authentication
crates/services/src/services/auth.rs - WebRTC connection
packages/remote-web/src/shared/lib/webrtc/connection.ts - Connection manager
packages/remote-web/src/shared/lib/webrtc/connectionManager.ts - Embedded SSH
crates/embedded-ssh/src/handler.rs - SFTP subsystem
crates/embedded-ssh/src/sftp.rs - Editor SSH setup
crates/desktop-bridge/src/service.rs - SSH configuration
crates/desktop-bridge/src/ssh_config.rs
Other components
- Engineer
- GitHub
- Coding agent
Connections 23
- Engineer → Local web app: plans work
README.md - Local web app → Kanban issues: manages issues
README.md - Engineer → Remote web app: uses hosted app
README.md - Kanban issues → API types: uses issue types
README.md - Local web app → Local server: uses local backend
README.md - Local server → Workspace management: creates workspaces
README.md - Workspace management → Git worktrees: provides branches
README.md - Workspace management → Agent executors: runs agents
README.md - Agent executors → Coding agent: dispatches work
README.md - Agent executors → Codex JSON-RPC: uses protocol
crates/executors/src/executors/codex/client.rs - Workspace management → Workspace state: persists sessions
- Engineer → Diff review: reviews diffs
README.md - Engineer → App preview: previews app
README.md - Engineer → Pull requests: creates pull requests
README.md - Pull requests → GitHub: opens and merges
README.md - Engineer → Review CLI: starts review
crates/review/src/main.rs - Review CLI → Agent session selection: selects sessions
crates/review/src/main.rs - Review CLI → Review archive: archives repository
crates/review/src/main.rs - Review CLI → Review service API: starts review
crates/review/src/main.rs - Remote API client → Remote authentication: uses credentials
crates/services/src/services/remote_client.rs - Connection manager → WebRTC connection: creates connection
packages/remote-web/src/shared/lib/webrtc/connectionManager.ts - Embedded SSH → SFTP subsystem: handles SFTP
crates/embedded-ssh/src/handler.rs - Editor SSH setup → SSH configuration: provisions SSH
crates/desktop-bridge/src/service.rs