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.10.tar.gz (363.9 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.10-py3-none-any.whl (340.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kenboard-0.2.10.tar.gz
  • Upload date:
  • Size: 363.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.28.1 CPython/3.13.15 Linux/6.17.0-1022-azure

File hashes

Hashes for kenboard-0.2.10.tar.gz
Algorithm Hash digest
SHA256 92220f64d4722fa096bbec23c98ac9ad30c52c088317dfecc8ceabccd7445cf3
MD5 febe5cba2d887b7feed185058ac298d0
BLAKE2b-256 fa922a974449e0ac6786a9c6cbc0d86cd82f786971eff7bfd92616e88bb70f70

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kenboard-0.2.10-py3-none-any.whl
  • Upload date:
  • Size: 340.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.28.1 CPython/3.13.15 Linux/6.17.0-1022-azure

File hashes

Hashes for kenboard-0.2.10-py3-none-any.whl
Algorithm Hash digest
SHA256 b3d294c98ba8bf0337f7adbb8ae382b546de9d9e40770bb7efbb1475c3c1d5fb
MD5 b5ba9a051d5d751d4ab318221ed565db
BLAKE2b-256 b9ef810b323e0f5bb29f2856c277f474d6980536d9fbc519b99e8923c685a6f8

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

This release

0.2.10 This release

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

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