MCPcopy Index your code
hub / github.com/Orenoid/harness-kanban

github.com/Orenoid/harness-kanban @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
2,165 symbols 5,280 edges 569 files 47 documented · 2%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Harness Kanban Logo Harness Kanban

Beta Build Unit Test Storybook Tests

Harness Kanban is a cloud-based kanban tool for managing fully containerized coding agents that run 24/7 to handle assigned issues. Currently supports Codex and Claude Code.

Screenshots

Harness Kanban screenshot

Collaborate with CodeBot like a real teammate.

Issue detail screenshot

Features

  • 🔄 Comprehensive Issue Lifecycle: Issues move through a human-in-the-loop workflow, from requirement clarification to plan review, implementation, help requests, code review, and completion.
  • 🐳 Fully Containerized: Each agent runs in an isolated, full-featured development container, can install dependencies like databases, and has YOLO mode on by default.
  • ☁️ Cloud Based: Both the kanban tool and coding agents can run in the cloud. No local CLI installation required.
  • 🧰 Harness Engineering: Agents run in a stable environment defined by your dev container specification, and the system forces the AI to keep repairing changes until user-defined validation commands and CI/CD checks pass.
  • ⚡ Highly Scalable: Built around a scalable worker orchestration architecture. Scale the number of concurrent workers based on your hardware resources. Agents automatically pick up available issues upon startup.
  • 🔔 Async Workflow: Automatically sends notifications when an issue requires your attention.

Prerequisites

  • Git
  • Docker with Docker Compose
  • GitHub account

Quick Start

  1. Clone the repository and enter the project directory:

bash git clone https://github.com/Orenoid/harness-kanban.git && cd harness-kanban

  1. Start the services:

bash docker compose up -d

You can run multiple workers when you need more parallel execution, for example:

bash docker compose up -d --scale worker=3

Each worker automatically claims queued issues after it starts up or after it finishes its current issue.
Start with 1-2 workers, then scale up based on your system's hardware utilization.

The number of workers you can run is limited by how many dev containers your machine can handle. Resource usage varies by project, so tune this according to your workload.

  1. Register an account, sign in, then open Settings to configure a GitHub token and at least one coding agent. Harness Kanban supports Claude Code and Codex.

  2. Create a project and a new issue, assign it to CodeBot, and you're on a roll.

Architecture

Harness Kanban architecture

Theoretically, you can deploy the worker anywhere that can connect to the project database (and, of course, has the necessary network access).

Future Plans

  • Build a Linear adapter and detach agent worker scheduling from the built-in kanban so Harness Kanban can integrate with more existing issue management systems.

Extension points exported contracts — how you extend this code

CreationPropertyProcessor (Interface)
(no doc) [9 implementers]
apps/api-server/src/property/types/property.types.ts
NotificationIssueReference (Interface)
(no doc)
packages/shared/src/notification/types.ts
NotificationInboxPanelViewProps (Interface)
(no doc)
apps/web/src/notification/components/notification-inbox-panel.tsx
AIProvider (Interface)
(no doc) [33 implementers]
apps/api-server/src/agent/ai-provider/ai-provider.types.ts
NotificationChangedProperty (Interface)
(no doc)
packages/shared/src/notification/types.ts
NotificationBellViewProps (Interface)
(no doc)
apps/web/src/notification/components/notification-bell.tsx
PreUpdateIssueHook (Interface)
(no doc) [5 implementers]
apps/api-server/src/issue/types/hook.types.ts
NotificationCommentReference (Interface)
(no doc)
packages/shared/src/notification/types.ts

Core symbols most depended-on inside this repo

cn
called by 234
apps/web/src/lib/shadcn/utils.ts
get
called by 229
apps/web/src/lib/api-server-client.ts
validateFormat
called by 96
apps/api-server/src/property/types/property.types.ts
send
called by 64
apps/api-server/src/pgmq/pgmq.service.ts
createToolPart
called by 63
apps/web/src/agent/components/tool-renderers/tool-renderers.stories.tsx
validateBusinessRules
called by 60
apps/api-server/src/property/types/property.types.ts
post
called by 40
apps/web/src/lib/api-server-client.ts
useApiServerClient
called by 39
apps/web/src/hooks/use-api-server.ts

Shape

Function 856
Method 702
Interface 324
Class 271
Enum 12

Languages

TypeScript100%

Modules by API surface

apps/api-server/src/harness-kanban/worker/coding-agent-workflow.service.ts55 symbols
apps/api-server/src/harness-kanban/worker/devpod.service.ts49 symbols
packages/shared/src/agent-tools/types.ts37 symbols
apps/api-server/src/harness-kanban/worker/github.service.ts36 symbols
apps/api-server/src/issue/issue.service.ts29 symbols
apps/web/src/components/ai-elements/code-block.tsx27 symbols
apps/web/src/agent/components/tool-renderers/tool-components.tsx24 symbols
apps/api-server/src/harness-kanban/worker/worker.service.ts22 symbols
apps/api-server/src/harness-kanban/worker/providers/harness-worker-claude-code.provider.ts22 symbols
packages/shared/src/coding-agent/types.ts20 symbols
apps/api-server/src/project/project.service.ts20 symbols
apps/api-server/src/harness-kanban/worker/providers/harness-worker-codex.provider.ts20 symbols

Datastores touched

harness_kanbanDatabase · 1 repos

For agents

$ claude mcp add harness-kanban \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact