KENBOARD

A kanban for BOTs.

For humans

KENBOARD kanban view

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

An admin clicks Copy onboard link on a project in the kenboard
The link is handed to the agent (Claude Code, GPT, etc.)
The agent opens the link and gets a complete .ken file with a pre-filled API token — zero human interaction for the API key
The agent runs pip install kenboard, creates the .ken, and starts working immediately

Daily workflow

ken list --status todo --who Claude --json   # assigned tasks
ken show <id> --json                         # task details
ken move <id> --to doing                     # mark in progress
ken add "MODULE / Title" --desc "..." --who Claude  # create
ken move <id> --to review                    # submit
ken wiki groom <id> <section>                # 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: 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.

ken wiki groom                       # list unclassified + sections
ken wiki groom <id> <section>        # 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 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. Pre-zipped sideload package on every release: GitHub Releases.

References

Full CLI: doc/ken-cli.md
Agent guide: ken help
REST API: doc/api.md, 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 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

Installation

See INSTALL.md for the full setup (MySQL, users, migrations, reverse proxy, OIDC).

License

MIT — see LICENSE.

Metadata

Release files for kenboard 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kenboard 0.4.5
File	Size	Uploaded
kenboard-0.4.5.tar.gz	379.6 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kenboard 0.4.5
File	Interpreter	ABI	Platform	Reset
kenboard-0.4.5-py3-none-any.whl 349.2 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 728.7 kB

Release files / kenboard-0.4.5.tar.gz

Download URL	kenboard-0.4.5.tar.gz
Size	379.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`79e8f1edaf3ee781980e7af9d6238c1e1d59a5cec4f30fd50b1ccb560b1a1e36`
BLAKE2b-256 checksum How to use checksums	`1e453f782bccf5e646ce1c219540c44d37fd2d0a6b89f978feec647865560346`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`pdm/2.29.2 CPython/3.12.3 Darwin/25.6.0`

Release files / kenboard-0.4.5-py3-none-any.whl

Download URL	kenboard-0.4.5-py3-none-any.whl
Size	349.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d0698f4b668a4392b7033dbc1dd53a0755f2385fdcea3ae181c9a78228d7d8ea`
BLAKE2b-256 checksum How to use checksums	`d0f6f0377568c52411cf2193d6659629071605b24a03c07b7e7b332ee82a78fe`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`pdm/2.29.2 CPython/3.12.3 Darwin/25.6.0`