Dev In The Mountain Header
A Developer In The mountains having fun

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:+3d or due:tomorrow, or pick from a calendar that pops up as you type due:
  • Recurring tasks with rec:1w (from completion) or rec:+1m (strict, good for bills)
  • Month calendar (c) and week agenda (w), with times of day from at: tags
  • In progress: status:doing and progress:40 shown 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 /name while typing a task
  • todo.sh-style CLI with -json output 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
TagMeaning
due:2026-12-01due date (relative dates you type become this)
t:2026-11-28threshold date, moved along by rec:
rec:1w, rec:+1mrepeat on completion
at:1430, at:3pmtime of day: agenda and alerts
alarm:2026-12-01T0730alarm date and time
status:doing, progress:40in progress

Search

TermMatches
milk, "buy milk"words or phrases (smartcase)
+Work, @phonea project / context
due:+1w, due:-3ddue within a week / in the last 3 days
due:overdue, due:nonepast due / no due date
pri:A-Cby priority
status:doing, progress:>50by progress
-termnegates any term

fs saves the current search to the sidebar.

Keys

KeyAction
j / k, g / Gmove, first / last
tab, h / lsidebar ⇄ tasks
aadd a task
e / enteredit
x / spacecomplete / reopen
p, + / -set / raise / lower priority
i, > / <toggle doing, progress ±10%
v, Vvisual mode, select all
yy / ybcopy the line / just the words
uundo
Aarchive done tasks
/, fs, ffsearch, save search, saved searches
s, Hcycle sort, hide / show done
c, wcalendar, week agenda
Ttheme picker
:command palette
?help

Rebind anything in the config:

toml
[keys]
top = "gg"
add = ["n", "ctrl+n"]

Command line

bash
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 login

Also 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.

lua
-- 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

bash
go install github.com/devinthemtn/katTasks@latest

Prebuilt 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.

More places to find me
Mental Health
follow me on Mastodon