KENBOARD

A kanban for BOTs.

kenboard logo

PyPI version Python versions License: MIT Build Publish codecov Docstring coverage Quality Gate Status Maintainability Rating Reliability Rating Security Rating Bugs Vulnerabilities Code Smells Technical Debt

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

  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

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

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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.4.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for luxyluxe from gravatar.com luxyluxe

Credits

Author: Q

License

MIT License (MIT)

Requires

Python >=3.11

Tags

kenboard kanban project-management flask mysql dashboard

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kenboard-0.2.7.tar.gz (365.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kenboard-0.2.7-py3-none-any.whl (337.7 kB view details)

Uploaded Python 3

File details

Details for the file kenboard-0.2.7.tar.gz.

File metadata

  • Download URL: kenboard-0.2.7.tar.gz
  • Upload date:
  • Size: 365.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.28.0 CPython/3.12.3 Darwin/25.5.0

File hashes

Hashes for kenboard-0.2.7.tar.gz
Algorithm Hash digest
SHA256 0a72529cef0e88d537a8fb60cc77083e3a8914112402cc2daaf34ae6ded5f162
MD5 370d75b211d2e464b5d40a18de8dbca6
BLAKE2b-256 c1a3762494489fec65af6a7cf0197002b3f4e0dac3ba99dee204044e89be20f0

See more details on using hashes here.

File details

Details for the file kenboard-0.2.7-py3-none-any.whl.

File metadata

  • Download URL: kenboard-0.2.7-py3-none-any.whl
  • Upload date:
  • Size: 337.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.28.0 CPython/3.12.3 Darwin/25.5.0

File hashes

Hashes for kenboard-0.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 fbb7cb12dfd2694bd974a3538f8c9b1f9e6ea61bc86c56f40a54de0a8b75b6e0
MD5 37bf269d12634d78a14824a33056bc69
BLAKE2b-256 26dfec089604cce21da49abe7258214028ed2e118d3b663861bd86c3997f85de

See more details on using hashes here.

Release history Release notifications | RSS feed

0.4.1

2 files

0.4.0

2 files

0.3.0

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

This release

0.2.7 This release

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.139

2 files

0.1.138

2 files

0.1.137

2 files

0.1.136

2 files

0.1.135

2 files

0.1.134

2 files

0.1.133

2 files

0.1.132

2 files

0.1.131

2 files

0.1.130

2 files

0.1.129

2 files

0.1.128

2 files

0.1.127

2 files

0.1.126

2 files

0.1.125

2 files

0.1.124

2 files

0.1.123

2 files

0.1.122

2 files

0.1.121

2 files

0.1.120

2 files

0.1.119

2 files

0.1.118

2 files

0.1.117

2 files

0.1.116

2 files

0.1.115

2 files

0.1.114

2 files

0.1.113

2 files

0.1.112

2 files

0.1.111

2 files

0.1.110

2 files

0.1.109

2 files

0.1.108

2 files

0.1.107

2 files

0.1.106

2 files

0.1.105

2 files

0.1.104

2 files

0.1.103

2 files

0.1.102

2 files

0.1.101

2 files

0.1.100

2 files

0.1.99

2 files

0.1.98

2 files

0.1.97

2 files

0.1.96

2 files

0.1.95

2 files

0.1.94

2 files

0.1.93

2 files

0.1.92

2 files

0.1.91

2 files

0.1.90

2 files

0.1.89

2 files

0.1.88

2 files

0.1.87

2 files

0.1.86

2 files

0.1.85

2 files

0.1.84

2 files

0.1.83

2 files

0.1.82

2 files

0.1.81

2 files

0.1.80

2 files

0.1.79

2 files

0.1.78

2 files

0.1.77

2 files

0.1.76

2 files

0.1.75

2 files

0.1.74

2 files

0.1.73

2 files

0.1.72

2 files

0.1.71

2 files

0.1.70

2 files

0.1.69

2 files

0.1.68

2 files

0.1.67

2 files

0.1.66

2 files

0.1.65

2 files

0.1.64

2 files

0.1.63

2 files

0.1.62

2 files

0.1.61

2 files

0.1.60

2 files

0.1.59

2 files

0.1.58

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.49

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.40

2 files

0.1.39

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.8

2 files

0.1.7

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page