How aaronyaml/tabbie works
Tabbie is a local command centre for coding agents, integrated with the Hermes hub and WebUI. The main flow routes a user request through the command-centre plugin: chat stays with the hub, scoped jobs go to Claude Code, and larger or ambiguous work can be planned with Codex before execution. Separate branches support project organization, attachment handling, usage and limits, work tracking, and motion creation. Traces feed the Dreamer’s evidence-backed memory proposals. Relationships reflect the README and source-index references; some unsampled subsystem links are therefore omitted.
Main entry points: __init__.py Request handler · routes.js WebUI extension · providers.py Worker provider · router.py Request classifier
Components 21
Request routing
- Request handler
plugin/command-centre/__init__.py - Request classifier
plugin/command-centre/router.py - Attachment ingestion
plugin/command-centre/attachments.py
Agent execution
- Planner provider
plugin/command-centre/providers.py - Worker provider
plugin/command-centre/providers.py - Claude Code
- Codex
- Hermes hub
Learning and memory
- Session traces
hmem/trace.py - Dreamer
hmem/dreamer.py - Memory proposals
hmem/proposals.py - Versioned memory
hmem/store.py - Memory retrieval
hmem/retrieve.py
Projects and workspace
- Project registry
hmem/projects.py
WebUI capabilities
- Web app
- WebUI extension
webui-extension/routes.js - Usage insights
plugin/command-centre/usage_insights.py - Usage limits
plugin/limits/__init__.py - Workboard
plugin/workboard/__init__.py - Motion studio
hmem/motion.py
Other components
- User
Connections 25
- User → Web app: sends request
README.md - Web app → WebUI extension: uses extension
README.md - WebUI extension → Request handler: passes messages
README.md - Request handler → Request classifier: classifies request
plugin/command-centre/__init__.py - Request handler → Attachment ingestion: ingests files
plugin/command-centre/__init__.py - Request handler → Planner provider: dispatches planning
plugin/command-centre/__init__.py - Request handler → Worker provider: dispatches execution
plugin/command-centre/__init__.py - Request handler → Hermes hub: keeps chat
README.md - Request classifier → Planner provider: selects route
README.md - Request classifier → Worker provider: selects route
README.md - Planner provider → Codex: plans work
README.md - Planner provider → Worker provider: approved plan
README.md - Worker provider → Claude Code: runs task
README.md - Worker provider → Codex: runs task
README.md - Request handler → Session traces: records run
README.md - Session traces → Dreamer: supplies evidence
README.md - Dreamer → Memory proposals: suggests lessons
hmem/dreamer.py - Memory proposals → Versioned memory: persists approved changes
hmem/proposals.py - Request handler → Memory retrieval: gets worker context
README.md - Memory retrieval → Versioned memory: searches memories
hmem/retrieve.py - Request handler → Project registry: uses project context
plugin/command-centre/__init__.py - WebUI extension → Usage insights: shows usage
README.md - WebUI extension → Usage limits: shows limits
README.md - WebUI extension → Workboard: shows workboard
README.md - WebUI extension → Motion studio: offers motion tools
README.md