MCPcopy Create free account
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% updated 23d ago★ 36

Browse by type

Functions 1,558 Types & classes 607
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

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

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

Ask about this repo answers extend the page