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

๐Ÿฑ The kat Suite

โ† Back to all my apps

A small family of apps built around the old Unix idea: do one thing well. Each kat app is focused on a single job and hands everything else off to the tools you already like (your editor, your markdown viewer, your diff tool), all user configurable. They work fine on their own, but they're designed to work loosely together.

The apps

katdown โ€” Markdown viewer (GUI)

A fast, vim-keyed markdown viewer. You edit in your own editor and katdown re-renders on every save. GitHub-flavored markdown, syntax highlighting, Mermaid diagrams and KaTeX math, all rendering offline.

Read more about katdown โ†’ ยท GitHub

katCompare โ€” Diff & merge (TUI & GUI)

Compare files, whole directories or git refs, then cherry-pick just the changes you want. Built-in git conflict resolver, and color-blind friendly: additions are blue, not green.

Read more about katCompare โ†’ ยท GitHub

katTasks โ€” todo.txt task manager (TUI, GUI & CLI)

A keyboard-driven task list for plain todo.txt files, with a search language, recurring tasks, a calendar and week agenda, alerts and alarms, and Lua scripting.

Read more about katTasks โ†’ ยท GitHub

katNotes โ€” Markdown notes & journal (TUI, GUI & CLI)

Notes and daily journal entries as plain markdown files with YAML front matter. Links and backlinks, tasks with due dates, templates, saved searches, git sync and Lua commands.

Read more about katNotes โ†’ ยท GitHub

What they have in common

  • Plain files, no lock-in. katTasks writes ordinary todo.txt, katNotes writes ordinary markdown with YAML front matter, and katdown and katCompare work on whatever files you already have. Anything the apps add (tags like due: or status:doing, front matter fields) is kept by other tools that don't understand it.
  • Your tools, not mine. Every app has an "open this in my editor" key, and the editor is set in the config (falling back to $VISUAL / $EDITOR). katCompare hands off to your external diff/merge tool, and katNotes previews with katdown, glow, mdcat or whatever you set.
  • One engine, several faces. The TUI, GUI and CLI of each app share the same Go core, so they read and write the same files and behave the same way.
  • Vim-style keys everywhere. j/k, gg/G, / to search, : for a command window, ? for help.
  • A simple config.toml. Each app creates its config with the defaults on first start and never overwrites it. katdown and katTasks have -makeconfig and -updateconfig flags, the second adding any new settings from a newer version as commented-out lines while leaving your own alone.
  • Themes. Light/dark themes plus your own theme files (or custom CSS, for katdown).
  • Lua scripting. katTasks and katNotes run your own Lua scripts, both from the : command window and as /name commands while typing.
  • WSL friendly. If you run Linux inside Windows with WSL, task install also builds and installs the Windows versions and adds a -win wrapper (katdown-win, katcmp-win, katTasks-win, katnotes-win) so you can open the native Windows app from your WSL shell. katTasks and katNotes even point the Windows app at your WSL files so both share one task list or one set of notes.
  • Built with Go. Desktop apps use Wails v3; terminal apps use Bubble Tea and Lip Gloss.

How they work together

They don't depend on each other, but they're nicer together:

  • katNotes + katdown: set previewer = "katdown" in katNotes (it's tried first by default) and p in the TUI opens the note in katdown. Links between notes are ordinary relative markdown links, so katdown can follow them from note to note.
  • katNotes + katTasks: both use plain-text tasks that grep well. Use katTasks for your main todo list and katNotes for tasks that belong inside a note or a journal day.
  • katCompare as everyone's diff tool: set it as your git difftool, or as the diff_tool for katbackup, my config-file backup tool:
bash
git config --global diff.tool katcmp
git config --global difftool.katcmp.cmd 'katcmp-win --wait "$LOCAL" "$REMOTE"'
  • Your editor in the middle: katdown, katCompare, katTasks and katNotes all open files in the same editor you've set, at the right line where the editor supports it.

Installing

Every app is built from source with Go and go-task (task install), and the GUIs also need Node and the Wails v3 CLI (plus the GTK 3 and WebKitGTK 4.1 dev packages on Linux). katCompare, katTasks and katNotes also have Windows installers that install per user with no admin rights. See each app's page for details.

More places to find me
Mental Health
follow me on Mastodon