How deepklarity/harness-kit works
Harness Kit combines Odin, a multi-agent orchestration CLI; Taskit, a task-board/API product with execution evidence and analytics; and a provider-quota CLI. The principal flow is spec planning into dependency-linked tasks, agent routing and sandboxed execution, then review/merge with results retained on the board. The README documents these product stages; sampled source confirms Odin’s orchestration/routing and the Taskit UI/service boundary. Backend and several capability details are represented at subsystem level because their implementation was not sampled.
Main entry points: orchestrator.py Spec orchestration · App.tsx Board dashboard · models.py Tasks and evidence · cli.py Odin CLI
Components 21
Odin orchestration
- Odin CLI
odin/src/odin/cli.py - Run configuration
odin/src/odin/config.py - Spec orchestration
odin/src/odin/orchestrator.py - Agent routing
odin/src/odin/agent_routing.py - Task graph
odin/src/odin/dag.py - Worktree sandbox
odin/src/odin/worktree.py - Task results
odin/src/odin/models.py - Review and reflection
odin/src/odin/reflection.py - Cost tracking
odin/src/odin/cost_tracking
Taskit board
- Board dashboard
taskit/taskit-frontend/src/App.tsx - Dashboard API client
taskit/taskit-frontend/src/services/harness/HarnessTimeService.ts - Board API
taskit/taskit-backend/tasks/views.py - Tasks and evidence
taskit/taskit-backend/tasks/models.py - Board execution
taskit/taskit-backend/tasks/dag_executor.py - Agent analytics
taskit/taskit-backend/tasks/agent_stats.py
Provider quotas
- Quota CLI
harness_usage_status/src/harness_usage_status/cli.py - Provider registry
harness_usage_status/src/harness_usage_status/providers/registry.py - Gemini quota
harness_usage_status/src/harness_usage_status/providers/gemini.py
Shared agent runtime
- Agent harnesses
odin/src/odin/harnesses
Other components
- Engineer
- AI providers
Connections 23
- Engineer → Odin CLI: runs
README.md - Odin CLI → Spec orchestration: starts
- Spec orchestration → Run configuration: uses settings
odin/src/odin/orchestrator.py - Spec orchestration → Agent routing: routes tasks
odin/src/odin/orchestrator.py - Spec orchestration → Task graph: decomposes work
README.md - Spec orchestration → Worktree sandbox: executes sandboxed
README.md - Spec orchestration → Agent harnesses: dispatches agents
README.md - Agent harnesses → AI providers: invokes
README.md - Spec orchestration → Task results: records results
odin/src/odin/orchestrator.py - Spec orchestration → Review and reflection: reviews work
README.md - Spec orchestration → Cost tracking: tracks spend
README.md - Engineer → Board dashboard: uses board
README.md - Board dashboard → Dashboard API client: calls
- Dashboard API client → Board API: requests data
README.md - Board API → Tasks and evidence: reads and writes
- Board dashboard → Board execution: monitors runs
README.md - Board execution → Tasks and evidence: updates task evidence
- Tasks and evidence → Agent analytics: supplies outcomes
taskit/taskit-backend/tasks/agent_stats.py - Agent analytics → Agent routing: informs assignments
README.md - Engineer → Quota CLI: checks quotas
harness_usage_status/src/harness_usage_status/cli.py - Quota CLI → Provider registry: selects provider
harness_usage_status/src/harness_usage_status/cli.py - Provider registry → Gemini quota: dispatches
harness_usage_status/src/harness_usage_status/providers/registry.py - Gemini quota → AI providers: queries quota API
harness_usage_status/src/harness_usage_status/providers/gemini.py