docs / overview
Kanbn Documentation
This is a CLI kanban board application. The kanban board and tasks live inside your repository as markdown files, so they are easy to read and edit in your IDE and you can benefit from source control, version history etc.
To get started quickly, check out the Quick Start guide.
Contents#
- Quick Start
- Library API — using
@basementuniverse/kanbnas a dependency instead of the CLI - Index Structure — the board file and all project options
- Task Structure — task files, metadata, sub-tasks, relations, comments and history
- Multiple Boards — several boards over one shared pool of tasks
- Contributors — an optional list of who works on a workspace, and who "you" are
- Actions — declarative rules that fire when a task is created, moved, updated or finished
- Views — custom board layouts, columns and lanes
- Sprints — named time windows that
status,burndownandhistoryreport through - Filtering and Sorting — the filter and sorter model shared by
find,sortand views - Tab Completion — completing task ids, columns and boards in bash, zsh and fish
- Advanced Configuration
- Migrating to 2.0.0 — separate config files and custom folder locations
Examples#
The example directory contains ready-to-run workspaces:
| Example | Demonstrates |
|---|---|
example/basic |
A typical board: columns, tags, workload, sprints |
example/views |
Views, lanes, filters and sorters |
example/boards |
Multiple boards over one shared pool of tasks, with per-board state fields |
example/advanced |
A kanbn.yml config file, custom fields, contributors, column sorting and a custom task template |
Run any Kanbn command from inside one of those directories to try it out.
Command help#
Every command has built-in help:
kanbn help <command>
kanbn <command> --helpFound a mistake? Edit this page on GitHub.