Skip to content
kandown
GitHubnpm

Using the board

View raw

Terminal UI

The keyboard-driven board that works over SSH, with no browser involved.

kandown board

A full kanban board in your terminal. Same files, same dependency gate, same everything — it is not a reduced view of the web UI, it is a peer of it.

It is the interface to reach for when you are on a remote machine, when you live in a terminal multiplexer, or when you simply do not want a browser tab open for a task list.

Keys

KeyAction
j / kMove between tasks
h / lMove between columns
nNew task
eEdit the task in $EDITOR
mMove to another column
/Fuzzy search
fCycle filters
aLaunch an agent on this task
gSend the task to your agent hook
xArchive
DDelete
dToggle the web daemon
rReload from disk
?Cheatsheet

Tip

e opens the raw Markdown file in $EDITOR. Since the file is the task, anything your editor can do — macros, multiple cursors, a spell checker — works on your board.

Mouse

The TUI is mouse-aware where terminals allow it: click to select, and drag a task between columns to move it.

Over SSH

Nothing about the terminal UI needs a local browser or a display server, so it works unchanged over SSH. The web daemon is separate and optional — toggle it with d if you also want the browser board, and forward the port if you want to reach it from your laptop:

ssh -L 5176:localhost:5176 you@server

Settings

kandown settings

A terminal settings editor covering the same configuration as the web Settings page: columns, theme, notifications, agents and the kandown work output.

Edit this page on GitHub →