https://github.com/lduchosal/kenboard
Self-hosted kanban bridging humans and AI coding agents (Claude Code, GPT): humans create and close tasks, agents claim them and move todo → doing → review via the 'ken' CLI. Per-project scoped API keys, OIDC, REST + CLI.
https://github.com/lduchosal/kenboard
Last synced: about 1 month ago
JSON representation
Self-hosted kanban bridging humans and AI coding agents (Claude Code, GPT): humans create and close tasks, agents claim them and move todo → doing → review via the 'ken' CLI. Per-project scoped API keys, OIDC, REST + CLI.
- Host: GitHub
- URL: https://github.com/lduchosal/kenboard
- Owner: lduchosal
- Created: 2026-04-06T21:45:30.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-06-16T15:17:17.000Z (about 1 month ago)
- Last Synced: 2026-06-16T17:13:11.090Z (about 1 month ago)
- Language: Python
- Size: 4.24 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KENBOARD
> **A kanban for BOTs.**
[](https://pypi.org/project/kenboard/)
[](https://pypi.org/project/kenboard/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/lduchosal/kenboard/actions/workflows/python-package.yml)
[](https://github.com/lduchosal/kenboard/actions/workflows/publish.yml)
[](https://codecov.io/gh/lduchosal/kenboard)
[](./interrogate_badge.svg)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
[](https://sonarcloud.io/summary/new_code?id=lduchosal_kenboard)
## For humans
> Regenerate the screenshot after a UI change: `pdm run screenshots`
## For BOTs
KENBOARD ships `ken`, a CLI built for Claude Code and other assistants:
JSON output, native filters, clean exit codes.
### Automatic onboarding
1. An admin clicks **Copy onboard link** on a project in the kenboard
2. The link is handed to the agent (Claude Code, GPT, etc.)
3. The agent opens the link and gets a complete `.ken` file with a
pre-filled API token — zero human interaction for the API key
4. The agent runs `pip install kenboard`, creates the `.ken`, and
starts working immediately
### Daily workflow
```sh
ken list --status todo --who Claude --json # assigned tasks
ken show --json # task details
ken move --to doing # mark in progress
ken add "MODULE / Title" --desc "..." --who Claude # create
ken move --to review # submit
ken wiki groom # classify for the wiki
```
Full workflow: `todo` → `doing` → `review` → `groom` → `done`.
The agent handles `todo` → `doing` → `review` then `ken wiki groom`.
Only the user moves `review` → `done`. `ken move --to review` and
`ken update --status review` print a one-line reminder about the
grooming step so the agent doesn't forget.
### Wiki — exporting the board as a structured doc tree (#376)
Inspired by Karpathy's
[LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f):
the kanban board is the source of truth, and an LLM agent classifies
each task into a section of `ARCHITECTURE.md` (a YAML-frontmatter file
at the project root that declares the wiki's section tree). The CLI
then exports the result as a navigable MD/HTML tree.
```sh
ken wiki groom # list unclassified + sections
ken wiki groom # assign a task to a section
ken wiki sync --out wiki # MD tree (committed in /wiki)
ken wiki build --in wiki --out wiki-html # standalone HTML
ken wiki lint --strict # orphans / unclassified (CI gate)
```
- The server stays unaware of `ARCHITECTURE.md` — it stores opaque
`(task_id, section_path)` pairs, the CLI does the validation.
- Each section index splits "En cours" (todo/doing/review) and
"Archivé" (done). Per-task pages mirror the board's full-screen
task view (header + meta + description).
- `ken wiki lint --strict` exits 1 on orphans / unclassified tasks
— wire it into your CI to keep the wiki in sync with the board.
A live snapshot of the export lives under [`/wiki`](./wiki) in this repo.
### Browser extension — quick-capture from any page (#480)
Sideload-only browser extension that pops a "create task" dialog from
the current tab with `Ctrl+Shift+K` (`Cmd+Shift+K` macOS). Pre-fills
the title from the page title, attaches a PNG screenshot of the
visible viewport, posts to `POST /api/v1/tasks` with your existing
api_key. Zero new server code — reuses the standard bearer auth.
Install + first-run guide: [`extension/README.md`](extension/README.md).
Pre-zipped sideload package on every release:
[GitHub Releases](https://github.com/lduchosal/kenboard/releases).
### References
- Full CLI: [`doc/ken-cli.md`](doc/ken-cli.md)
- Agent guide: `ken help`
- REST API: [`doc/api.md`](doc/api.md), [`doc/openapi.yaml`](doc/openapi.yaml)
## Enterprise
KENBOARD is designed for self-hosted enterprise deployment:
- **OIDC authentication** — sign in through a corporate Identity
Provider (Microsoft ADFS, Google Workspace, Authentik, Keycloak,
etc.) alongside or instead of password login. See
[`doc/oidc-adfs.md`](doc/oidc-adfs.md) for the ADFS guide.
- **Self-hosted** — no cloud dependencies. MySQL + Flask + gunicorn
on your own infrastructure, behind your reverse proxy / WAF.
- **Per-project API keys** — each agent or integration gets a
scoped token (read/write) for a specific project. AI agents
self-onboard through the runbook served by the server.
- **Commercial support** — setup assistance, IdP integration, and
operational support available on request.
Contact: [2113.ch](https://www.2113.ch)
## Installation
See [`INSTALL.md`](INSTALL.md) for the full setup (MySQL, users,
migrations, reverse proxy, OIDC).
## License
MIT — see [`LICENSE`](LICENSE).