How vibex-ai/vibex works
Vibex is a local-first AI coding workbench spanning desktop, terminal, and mobile clients. The main workflow is to configure an Agent and Providers, work in a project, submit tasks to Agent sessions, inspect edits and tool activity, and review changes; sessions can also be monitored remotely. The graph preserves documented capabilities including teams, browser/computer use, previews, gateway routing, remote runtimes, and Relay. Several subsystem links are documented rather than verified from sampled implementation, so those edges cite the README; unsampled internals are represented at their source paths.
Main entry points: manager.rs Agent runtime · main.rs Desktop workbench · workbench.rs Workspace workbench · app.rs Terminal UI
Components 25
User clients
- Desktop workbench
apps/desktop/src/main.rs - Terminal UI
crates/vibex-tui/src/app.rs - TUI worker
crates/vibex-tui/src/worker.rs - Mobile client
apps/mobile/src/app.rs
Agents and sessions
- Agent runtime
crates/agent/src/manager.rs - ACP adapters
crates/agent-acp/src/runtime.rs - Agent teams
crates/agent/src/delegation.rs - Session timeline
crates/core/src/timeline.rs
Workspace tools
- Workspace workbench
crates/desktop-runtime/src/workbench.rs - Git review
crates/git/src/lib.rs - Terminal sessions
crates/terminal/src/lib.rs - Browser tools
crates/browser/src/service.rs - Computer use
crates/computer/src/service.rs - Document previews
crates/content/src/lib.rs
Runtime services
- Provider management
apps/desktop/src/management.rs - Gateway routing UI
apps/desktop/src/management/provider_workspace/routes.rs - Model gateway
crates/model-gateway/src/service.rs - Gateway HTTP API
crates/model-gateway/src/server.rs - Durable state
crates/db/src/lib.rs
Remote access
- Remote server
apps/server/src/main.rs - Remote client
crates/vibex-remote-client/src/backend.rs - Pairing
crates/remote/src/lan_pairing.rs - Optional Relay
crates/relay/src/lib.rs - SSH runtime
apps/desktop/src/ssh_connection/service.rs
Other components
- User
Connections 27
- User → Desktop workbench: uses
README.md - User → Terminal UI: uses
README.md - User → Mobile client: uses
README.md - Desktop workbench → Agent runtime: controls
README.md - Terminal UI → TUI worker: dispatches effects
crates/vibex-tui/src/app.rs - TUI worker → Agent runtime: steers sessions
- Agent runtime → ACP adapters: runs adapters
README.md - Agent runtime → Agent teams: delegates tasks
README.md - Agent runtime → Session timeline: records activity
README.md - Desktop workbench → Workspace workbench: opens workspace
README.md - Workspace workbench → Git review: reviews changes
README.md - Workspace workbench → Terminal sessions: hosts terminal
README.md - Agent runtime → Browser tools: drives browser
README.md - Agent runtime → Computer use: controls machine
README.md - Workspace workbench → Document previews: previews files
README.md - Desktop workbench → Provider management: configures
README.md - Provider management → Gateway routing UI: edits routes
apps/desktop/src/management/provider_workspace/routes.rs - Provider management → Durable state: stores configuration
- Model gateway → Durable state: reads configuration
crates/model-gateway/src/service.rs - Gateway HTTP API → Model gateway: handles requests
crates/model-gateway/src/server.rs - Agent runtime → Gateway HTTP API: requests models
- Mobile client → Remote client: connects remotely
- Terminal UI → Remote client: attaches remotely
- Remote client → Remote server: connects to
- User → Pairing: pairs devices
README.md - Remote server → Optional Relay: uses encrypted frames
- Desktop workbench → SSH runtime: connects runtimes
README.md