Repository navigation
katTasks 0.3.0
katTasks 0.3.0 adds Lua scripts and a new popup for adding and editing tasks.
Install
Prebuilt: download the archive for your system below, unpack it and put katTasks (or katTasks.exe) somewhere on your PATH. Builds are static, with no dependencies:
| system | file |
|---|---|
| Linux x86-64 / ARM64 | katTasks_0.3.0_linux_amd64.tar.gz / …_linux_arm64.tar.gz |
| macOS Intel / Apple silicon | katTasks_0.3.0_darwin_amd64.tar.gz / …_darwin_arm64.tar.gz |
| Windows x86-64 / ARM64 | katTasks_0.3.0_windows_amd64.zip / …_windows_arm64.zip |
checksums.txt has SHA-256 sums (sha256sum -c checksums.txt). The macOS builds aren't signed, so the first time you run one, macOS may block it; allow it in System Settings → Privacy & Security, or run xattr -d com.apple.quarantine katTasks.
With Go 1.24+:
go install github.com/devinthemtn/katTasks@v0.3.0
New
-
Lua scripts. Put
.luafiles inscripts/next toconfig.toml(~/.config/katTasks/scripts/on Linux). A-- commenton the first line becomes the script's description. Each script runs two ways:- From
:asscript:NAME, working on the task under the cursor. - While typing a task as a
/NAMEword. Typing/suggests up to five matching scripts,tabruns one, and any/NAMEleft in the text runs when you save. What the script returns replaces the word.
Scripts get a
kattable:kat.input,kat.task,kat.tasks(),kat.today,kat.date("fri"),kat.add(line),kat.update(line)andkat.status(msg). Everything one script changes is a single undo step, and a script is stopped after 2 seconds. Scripts are your own files and get the full Lua standard library, including file and system access.-- due a week from today return "due:" .. kat.date("+1w")
- From
-
Add/edit popup.
aandeopen a box in the middle of the screen, with completions under the input and a reminder of the(A),+project,@context,due:,rec:and/scriptsyntax. -
Version on the help screen.
?shows the running version next to the title.
Upgrading from 0.2
Nothing to change: settings, keys and todo.txt files work as before.
See the README for the full script reference.