How agentwrapper/agent-orchestrator works
Agent Orchestrator is a local workspace for planning, running, and supervising coding-agent tasks through review and merge. The main workflow is to choose a project and task, launch an agent in an isolated workspace, follow its session and changes, then inspect its pull request and review status on the Kanban. Project-level orchestration delegates focused work to workers. The graph reflects documented capabilities and sampled call paths; some subsystem wiring is not shown because its source was not sampled.
Main entry points: manager.go Session manager · useWorkspaceQuery.ts Workspace queries · kanban.go Kanban state · workspace_review_handlers.go Workspace review
Components 19
Workspace interface
- Workspace queries
frontend/src/renderer/hooks/useWorkspaceQuery.ts
Session execution
- HTTP API
backend/internal/httpd/api.go - Session controllers
backend/internal/httpd/controllers/sessions.go - Session manager
backend/internal/session_manager/manager.go - Workspace providers
backend/internal/adapters/workspace/router/router.go - Terminal runtime
backend/internal/adapters/runtime/runtimeselect/runtimeselect.go - Chat controller
backend/internal/service/chat/controller.go - Session lifecycle
backend/internal/lifecycle/manager.go
Agent integration
- Agent registry
backend/internal/adapters/agent/registry/registry.go - Chat drivers
backend/internal/adapters/chatdriver/registry/registry.go
Planning and tracking
- Project orchestrator
backend/internal/cli/orchestrator.go - Worker coordination
cloud/internal/httpapi/worker_orchestration_handlers.go - Kanban state
backend/internal/domain/kanban.go - Workspace review
cloud/internal/httpapi/workspace_review_handlers.go
Source control
- SCM providers
backend/internal/adapters/scm/multi/provider.go - Issue trackers
backend/internal/adapters/tracker/multi/tracker.go
Other components
- Desktop user
- GitHub
- GitLab
Connections 20
- Desktop user → Workspace queries: uses
- Workspace queries → HTTP API: requests workspace data
- HTTP API → Session controllers: routes requests
- Session controllers → Session manager: manages sessions
- Session manager → Workspace providers: creates workspaces
- Session manager → Terminal runtime: starts runtime
- Session manager → Agent registry: resolves agents
- Session manager → Chat controller: controls chat sessions
- Chat controller → Chat drivers: uses chat driver
- Session manager → Session lifecycle: updates lifecycle
- Desktop user → Project orchestrator: plans work
- Project orchestrator → Worker coordination: delegates workers
- Worker coordination → Kanban state: contributes session state
- Workspace queries → Kanban state: displays board
- Workspace review → Workspace providers: dispatches workspace review
- Workspace review → Kanban state: publishes workspace changes
- SCM providers → GitHub: connects
- SCM providers → GitLab: connects
- Issue trackers → GitHub: connects
- Issue trackers → GitLab: connects