Skip to content

katTasks 0.3.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 23:48
· 26 commits to main since this release

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 .lua files in scripts/ next to config.toml (~/.config/katTasks/scripts/ on Linux). A -- comment on the first line becomes the script's description. Each script runs two ways:

    • From : as script:NAME, working on the task under the cursor.
    • While typing a task as a /NAME word. Typing / suggests up to five matching scripts, tab runs one, and any /NAME left in the text runs when you save. What the script returns replaces the word.

    Scripts get a kat table: kat.input, kat.task, kat.tasks(), kat.today, kat.date("fri"), kat.add(line), kat.update(line) and kat.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")
  • Add/edit popup. a and e open a box in the middle of the screen, with completions under the input and a reminder of the (A), +project, @context, due:, rec: and /script syntax.

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