katTasks
← The kat Suite · GitHub · Releases
A keyboard-driven task manager for todo.txt files (TUI, GUI & CLI).
Your tasks stay in plain todo.txt, readable and editable by any other tool, so there's no data lock-in. Everything katTasks adds is an ordinary key:value tag that other todo.txt apps keep and ignore.
Features
- Sidebar of projects, contexts and saved searches, each with a count of open tasks
- Vim-style keys, two-key chords (
yy,gg), visual multi-select, undo, and a fuzzy command palette (:) - Every key can be rebound, and you can pick a built-in theme (default, terminal, nord, gruvbox, dracula) or write your own
- A search language:
+Work due:+1w -@waiting pri:A-C status:doing - Natural due dates: type
due:fri,due:+3dordue:tomorrow, or pick from a calendar that pops up as you typedue: - Recurring tasks with
rec:1w(from completion) orrec:+1m(strict, good for bills) - Month calendar (
c) and week agenda (w), with times of day fromat:tags - In progress:
status:doingandprogress:40shown as badges like▰▰▱▱▱ 40% - Alerts at a task's
at:time and alarms that ring like an alarm clock, with a background reminder for when katTasks is closed - Lua scripts, run from
:or as/namewhile typing a task - todo.sh-style CLI with
-jsonoutput for scripting - Archiving to
done.txt - Safe saves: atomic writes, only changed lines are rewritten, and edits are refused if another program changed the file until you reload
Your todo.txt
A katTasks task is just a todo.txt line:
(A) 2026-11-18 Pay rent +Home due:2026-12-01 rec:+1m
Standup @work at:930
Leave for airport alarm:2026-12-01T0530
Write report +Work status:doing progress:40
| Tag | Meaning |
|---|---|
due:2026-12-01 | due date (relative dates you type become this) |
t:2026-11-28 | threshold date, moved along by rec: |
rec:1w, rec:+1m | repeat on completion |
at:1430, at:3pm | time of day: agenda and alerts |
alarm:2026-12-01T0730 | alarm date and time |
status:doing, progress:40 | in progress |
Search
| Term | Matches |
|---|---|
milk, "buy milk" | words or phrases (smartcase) |
+Work, @phone | a project / context |
due:+1w, due:-3d | due within a week / in the last 3 days |
due:overdue, due:none | past due / no due date |
pri:A-C | by priority |
status:doing, progress:>50 | by progress |
-term | negates any term |
fs saves the current search to the sidebar.
Keys
| Key | Action |
|---|---|
j / k, g / G | move, first / last |
tab, h / l | sidebar ⇄ tasks |
a | add a task |
e / enter | edit |
x / space | complete / reopen |
p, + / - | set / raise / lower priority |
i, > / < | toggle doing, progress ±10% |
v, V | visual mode, select all |
yy / yb | copy the line / just the words |
u | undo |
A | archive done tasks |
/, fs, ff | search, save search, saved searches |
s, H | cycle sort, hide / show done |
c, w | calendar, week agenda |
T | theme picker |
: | command palette |
? | help |
Rebind anything in the config:
[keys]
top = "gg"
add = ["n", "ctrl+n"]Command line
katTasks add "Pay rent +Home due:2026-12-01 rec:+1m"
katTasks ls +Home due:+1m
katTasks do 3
katTasks -json ls pri:A | jq '.[].text'
katTasks alarm +5m Tea is ready
katTasks alert in 20m Move the laundry
katTasks alerts # what's coming up this week
katTasks remind -install # background reminder at loginAlso append, prepend, replace, pri, depri, del, archive, lsa, lsp, lsprj, lsc, start, stop, status, progress and at.
Lua scripts
Drop .lua files in ~/.config/katTasks/scripts/. Run them from : as script:name, or type /name while adding a task and what the script returns replaces the word. Scripts get a kat table with the current input, the task under the cursor, all tasks, date helpers, and functions to add tasks or show a pick list.
-- due a week from today
return "due:" .. kat.date("+1w")See SCRIPTING.md for the full guide.
Desktop app
katTasks-gui is the same task list in a window for Linux, macOS and Windows, with the same keys, themes, saved searches and scripts, reading the same settings and todo.txt. It adds mouse support (click to select, double-click to edit, click [ ] to complete), a clickable calendar, a seven-column agenda, configurable fonts and zoom, and the system clipboard.
Install
go install github.com/devinthemtn/katTasks@latestPrebuilt binaries for Linux, macOS and Windows (x86-64 and ARM64) are on the releases page, and the Windows setup installs both the terminal app and the desktop app, plus the background reminder. To build the desktop app from source, run task install with Go 1.26, Node, and the Wails v3 CLI. Under WSL it installs the Windows versions and points them at your WSL todo.txt, so both share one list.

