How kdlbs/kandev works
Kandev is a self-hostable control plane for managing parallel tasks, orchestrating AI agents through configurable workflows, and reviewing their changes in an integrated workspace. The principal flow is task creation and workflow execution in an isolated runtime, followed by human review. The graph also preserves documented integrations, statistics, and the developing Office-mode capabilities. Several backend subsystems are represented at their existing directory paths because their implementations were not sampled; edges use README documentation where it establishes the relationship.
Main entry points: lifecycle Runtime lifecycle · tasks-page-client.tsx Task management · task Task services · engine.go Workflow engine
Components 18
Task orchestration
- Task management
apps/web/app/tasks/tasks-page-client.tsx - Task services
apps/backend/internal/task - Workflow engine
apps/backend/internal/workflow/engine/engine.go - Agent orchestrator
apps/backend/internal/orchestrator
Agent execution
- Worktree isolation
apps/backend/internal/worktree - Runtime lifecycle
apps/backend/internal/agent/runtime/lifecycle - Agent providers
apps/backend/internal/agent/agents - Integrated workspace
apps/backend/internal/agent/handlers - Agent runtime client
apps/backend/internal/agent/runtime/agentctl
Review and insights
- Statistics dashboard
apps/web/app/stats - Change review
apps/backend/internal/task/service/review_service.go
External integrations
- GitLab workspace
apps/web/app/gitlab/gitlab-page-client.tsx - GitLab page state
apps/web/app/gitlab/use-gitlab-page-state.ts - Issue integrations
apps/backend/internal
Office mode
- Office dashboard
apps/web/app/office/page-client.tsx - Office capabilities
apps/backend/internal/office
Other components
- Developer
- Connected services
Connections 15
- Developer → Task management: manages tasks
README.md - Task management → Task services: creates tasks
- Task services → Workflow engine: runs workflow
- Workflow engine → Agent orchestrator: orchestrates agents
- Agent orchestrator → Runtime lifecycle: starts runtime
- Runtime lifecycle → Worktree isolation: isolates workspace
- Runtime lifecycle → Agent providers: runs provider
- Agent runtime client → Integrated workspace: serves workspace tools
- Developer → GitLab workspace: views issues
README.md - GitLab workspace → GitLab page state: uses page state
apps/web/app/gitlab/gitlab-page-client.tsx - Connected services → Issue integrations: provides issues
README.md - Developer → Statistics dashboard: views activity
README.md - Developer → Change review: reviews changes
README.md - Developer → Office dashboard: manages teams
README.md - Office dashboard → Office capabilities: uses office features