package

github.com/baltavay/quests.cr

master / published May 16, 2026 / repository

A terminal-based quest management application built with Crystal. Manage your quests a terminal interface.

quests.cr

Terminal todo app for Omarchy. Built with Crystal and crubbletea.

Usage

quests                         Launch TUI
quests add "Buy milk"          Quick add
quests done 3                  Toggle done by id
quests list                    Print tasks to terminal
quests --waybar                Waybar JSON output
quests --count                 Print pending count

Keybindings

KeyAction
aAdd quest
eEdit quest
dDelete quest
enterView details
spaceToggle done
/Filter
?Help
qQuit

Waybar

"custom/quests": {
  "exec": "/path/to/bin/quests --waybar",
  "return-type": "json",
  "format": "{}",
  "on-click": "omarchy-launch-floating-terminal-with-presentation /path/to/bin/quests",
  "interval": 30
}

Build

make          # shards build --release
make clean    # remove binary

Binary at bin/quests. Data stored in ~/.local/share/quests/data.json.

API