Skip to content

kenzie/kenban

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kenban

Plain-text personal kanban for solo developers. Trello for one, in a text file.

Install

Requires Go 1.26+.

git clone <repo-url> && cd kenban
make install

This builds the binary and installs kenban (and kb shortcut) to ~/.local/bin. Make sure ~/.local/bin is in your PATH.

Usage

kb is an alias for kenban — they are interchangeable.

Interactive board

kenban open

Opens a TUI kanban board with three sections (todo, doing, done) in a single-column layout.

Keyboard shortcuts

Key Action
↑ / ↓ Navigate (traverses all sections)
Advance task (todo→doing→done)
Move task back one column
b Toggle #blocked tag
n Add new task
Enter Edit selected task (inline)
x Delete selected task
q Quit
? Help

Add a task

kenban add "[myproject] Stripe onboarding"
kenban add "[myproject] Fix auto-reload bug @high +payments"

Tasks are created in [todo] state.

List tasks

kenban list               # all tasks
kenban list myproject     # filter by project

Filter by state

kenban state doing
kenban state done

Move a task

kenban move 3 doing       # move task 3 to doing
kenban done 3             # shortcut: move task 3 to done

Edit a task

kenban edit 3             # opens in $EDITOR (default: vi)

Copy a task to clipboard

kenban copy 3             # copies task 3 text to clipboard

Uses pbcopy on macOS, xclip or xsel on Linux.

List projects

kenban projects

Task format

One task per line in tasks.txt:

[state] [project] description @tag +label
  • state: todo, doing, done
  • project: any name in brackets
  • description: free text, may include @tags, +labels, or #blocked

Example:

[todo] [myproject] Stripe onboarding @high +payments
[doing] [myproject] Fix auto-reload bug
[todo] [myproject] Budget export waiting on schema #blocked
[done] [myproject] Initial billing model

File location

kenban looks for tasks in this order:

  1. ./tasks.txt (current directory)
  2. ~/.kenban/tasks.txt (home directory)

The file and directories are created automatically if they don't exist.

Development

make build    # build binary
make test     # run tests
make clean    # remove binary

About

Text based todo TUI/CLI app built in Go

Resources

Stars

Watchers

Forks

Contributors