# kanbot

kanbot runs a team of Claude Code or Codex agents from a GitHub Project board. You write and prioritize issues. Agents plan, build, review and fix. You approve plans and merge PRs.

## Demo

One card from idea to a reviewed PR, in about 7 minutes (3 minute video).

<video src="./assets/demo.mp4" poster="./assets/demo-poster.jpg" controls muted playsinline preload="none" width="100%"></video>

## Learn

Read these in order the first time.

1. [Getting started](./getting-started.md): install and set up a repo.
2. [Development flow](./workflow.md): how work moves across the board, and where you step in.
3. [Capturing ideas](./capturing-ideas.md): file ideas by chatting with your agent, from anywhere.
4. [Working outside the board](./outside-the-board.md): local sessions, your own PRs, direct commits.

## Customize

5. [Capabilities](./capabilities.md): hand the work on code to your own skills and agents.
6. [Agents](./agents.md): the agent team and how to change it.
7. [Skills](./skills.md): shared know-how and project conventions.
8. [Project memory](./project-memory.md): corrections on PRs become facts agents keep.
9. [Configuration](./configuration.md): config file, labels and notifications.

## Options

10. [Providers](./providers.md): use Claude or Codex.
11. [Identity and merging](./identity.md): talk as a kanbot bot, and merge by approving.
12. [Copilot review](./copilot-review.md): add GitHub Copilot as a cloud reviewer.

## Reference

13. [Upgrading](./upgrading.md): get new agents and skills, keep your edits.
14. [CLI usage](./usage.md): every command and flag.