How novshi-tech/boid works
boid is a local AI coding-agent orchestrator: a user creates and monitors tasks through the CLI or Web UI, while the daemon manages task state and runs agent work in isolated, write-scoped sandboxes. The main domain stages are task request, execution, verification/fix cycles, and completion; cards, scheduled triggers, projects, and workspace management provide related workflows. The graph highlights the API/orchestration/dispatch layers and the sandboxed agent runtime. README capabilities inform unsampled branches; detailed wiring is limited to the supplied excerpts and file tree.
Main entry points: service.go HTTP API · runner.go Sandbox runtime · task_service.go Task services · coordinator.go Lifecycle engine
Components 19
User interfaces
- CLI commands
cmd/root.go - Web UI
internal/api/web.go - Unix client
internal/client/client.go
Daemon services
- Daemon server
internal/server/server.go - HTTP API
internal/api/service.go - SQLite state
internal/db/db.go
Task domain
- Task services
internal/api/task_service.go - Lifecycle engine
internal/orchestrator/coordinator.go - Card workflows
internal/orchestrator/card.go - Trigger scheduler
internal/api/trigger_loop.go - Projects
internal/api/project_service.go - Workspaces
internal/api/workspace.go
Agent runtime
- Job dispatcher
internal/dispatcher/runner.go - Sandbox runtime
internal/sandbox/runner/runner.go - Agent adapters
internal/adapters/registry/registry.go - Egress controls
internal/sandbox/proxy_manager.go
Gateways
- API gateway
internal/apigateway/server.go - Git gateway
internal/gitgateway/server.go
Other components
- Operator
Connections 20
- Operator → CLI commands: issues commands
- Operator → Web UI: views and steers
- CLI commands → Unix client: sends requests
- Unix client → Daemon server: calls daemon
- Web UI → HTTP API: uses web routes
- Daemon server → HTTP API: serves routes
- HTTP API → Task services: handles task requests
- Task services → Lifecycle engine: coordinates lifecycle
- Lifecycle engine → SQLite state: persists state
- Task services → SQLite state: reads and writes
- HTTP API → Card workflows: dispatches card actions
- HTTP API → Trigger scheduler: runs scheduled triggers
- HTTP API → Projects: manages projects
- HTTP API → Workspaces: manages workspaces
- Lifecycle engine → Job dispatcher: dispatches jobs
- Job dispatcher → Sandbox runtime: runs sandbox jobs
- Job dispatcher → Agent adapters: invokes agent
- Sandbox runtime → Egress controls: controls egress
- Sandbox runtime → API gateway: routes API traffic
- Sandbox runtime → Git gateway: routes Git traffic