๐ฑ The kat Suite
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.
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:orstatus: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-makeconfigand-updateconfigflags, 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/namecommands while typing. - WSL friendly. If you run Linux inside Windows with WSL,
task installalso builds and installs the Windows versions and adds a-winwrapper (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) andpin 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 thediff_toolfor katbackup, my config-file backup tool:
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.

