How cyhhao/vibe-remote works
Avibe is a local-first agent platform: users configure agents and model sources, then steer agent sessions from the Workbench or connected messaging platforms. Agent backends execute work; durable sessions, projects, settings, and activity support ongoing use. The README also describes scheduled and watched background work, a Model Hub gateway, and agent-built Show Pages. The graph combines those documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; several product branches are documented but their internal wiring was not sampled.
Main entry points: controller.py Controller · service.py Agent service · App.tsx Browser Workbench · client.py Gateway runtime
Components 20
User entry points
- Browser Workbench
ui/src/App.tsx - Messaging platforms
modules/im
Control plane
- Controller
core/controller.py - Configuration
config/v2_config.py - Agent catalog
core/vibe_agents.py - Session services
storage/sessions_service.py - Workbench sessions
storage/workbench_sessions_service.py - Internal control API
vibe/internal_client.py
Agent runtime
- Agent service
modules/agents/service.py - Claude backend
modules/agents/claude_agent.py - Codex backend
modules/agents/codex/agent.py - OpenCode runtime
modules/agents/opencode/server.py
Product capabilities
- Model Hub
core/handlers/model_hub/service.py - Gateway runtime
vibe/model_hub_runtime/client.py - Agent Harness
core/scheduled_tasks.py - Show Pages
core/show_pages.py - Workbench apps
ui/src/components/Workbench.tsx
Local state
- Local database
storage/db.py - Local data paths
config/paths.py
Other components
- User
Connections 28
- User → Browser Workbench: steers via
README.md - User → Messaging platforms: steers via
README.md - Browser Workbench → Controller: dispatches turns
- Messaging platforms → Controller: dispatches messages
core/controller.py - Controller → Agent service: coordinates agents
core/controller.py - Controller → Configuration: loads config
core/controller.py - Controller → Agent catalog: uses catalog
core/controller.py - Controller → Model Hub: prepares gateway
core/controller.py - Browser Workbench → Workbench apps: opens apps
ui/src/App.tsx - Browser Workbench → Workbench sessions: manages sessions
- Workbench sessions → Local database: queries sessions
storage/workbench_sessions_service.py - Session services → Local database: persists sessions
storage/sessions_service.py - Controller → Internal control API: serves control
vibe/internal_client.py - Agent service → Session services: settles turns
modules/agents/service.py - Agent service → Claude backend: runs backend
modules/agents/service.py - Agent service → Codex backend: runs backend
- Agent service → OpenCode runtime: runs backend
- User → Model Hub: configures sources
README.md - Model Hub → Gateway runtime: routes requests
- Gateway runtime → Claude backend: serves models
README.md - Gateway runtime → Codex backend: serves models
README.md - Gateway runtime → OpenCode runtime: serves models
README.md - User → Agent Harness: schedules work
README.md - Agent Harness → Messaging platforms: delivers notices
README.md - Agent service → Show Pages: builds pages
README.md - Session services → Agent catalog: binds agents
storage/sessions_service.py - Configuration → Local data paths: uses data paths
config/v2_config.py - Local database → Local data paths: stores local state
storage/db.py