How avibe-bot/avibe works
Avibe is a local-first agent runtime with browser and messaging-app clients. A user submits work through the Workbench or a chat platform; the controller dispatches it to a configured agent backend, maintains session state, and returns output through the originating channel. Major parallel capabilities include Model Hub routing, durable scheduled and watched work, project/session management, agent cataloguing, and agent-built Show Pages. The README documents product-level flows; source excerpts are partial, so internal links not directly evidenced are omitted.
Main entry points: App.tsx Workbench · session_handler.py Session Handler · controller.py Runtime Controller · v2_config.py Model Configuration
Components 21
User Interfaces
- Workbench
ui/src/App.tsx - Messaging Apps
modules/im
Agent Runtime
- Runtime Controller
core/controller.py - Message Dispatch
core/message_dispatcher.py - Session Handler
core/handlers/session_handler.py - Agent Service
modules/agents/service.py - Agent Backends
modules/agents/catalog.py - Message Output
core/message_output.py
Model Hub
- Model Hub Service
core/handlers/model_hub/service.py - Gateway Runtime
vibe/model_hub_runtime/client.py - Model Configuration
config/v2_config.py
Durable Work
- Schedules and Watches
core/scheduled_tasks.py - Agent Catalog
core/vibe_agents.py - Show Pages
core/show_pages.py
Local State
- Session Services
storage/sessions_service.py - Workbench Sessions
storage/workbench_sessions_service.py - Settings Manager
modules/settings_manager.py - Config Storage
config/paths.py - Local Database
storage/db.py
Other components
- User
- Claude, Codex, OpenCode
Connections 25
- User → Workbench: uses
README.md - User → Messaging Apps: messages
README.md - Workbench → Runtime Controller: submits work
- Messaging Apps → Runtime Controller: delivers messages
core/controller.py - Runtime Controller → Message Dispatch: dispatches
core/controller.py - Message Dispatch → Session Handler: routes turns
- Session Handler → Agent Service: starts turns
- Agent Service → Agent Backends: selects backend
modules/agents/service.py - Agent Backends → Claude, Codex, OpenCode: drives CLIs
README.md - Session Handler → Session Services: manages sessions
core/handlers/session_handler.py - Session Handler → Message Output: produces replies
core/handlers/session_handler.py - Message Output → Messaging Apps: delivers replies
- Workbench → Workbench Sessions: manages sessions
- Model Hub Service → Model Configuration: configures routes
core/handlers/model_hub/service.py - Gateway Runtime → Model Configuration: reads configuration
vibe/model_hub_runtime/client.py - Agent Backends → Gateway Runtime: uses gateway
README.md - Runtime Controller → Settings Manager: sets up platforms
core/controller.py - Settings Manager → Model Configuration: reads settings
- Schedules and Watches → Session Services: uses sessions
- Agent Catalog → Local Database: persists agents
core/vibe_agents.py - Workbench → Agent Catalog: manages agents
README.md - Workbench → Show Pages: opens Show Pages
README.md - Session Services → Local Database: stores session state
storage/sessions_service.py - Workbench Sessions → Local Database: queries sessions
storage/workbench_sessions_service.py - Config Storage → Model Configuration: provides config paths
config/v2_config.py