go22dos

go22dos is a small TUI for browsing and completing tasks on a Vikunja instance.

Usage

go22dos [options]

flag	meaning
-config <file.toml>	load settings from a toml file
-color <name>	highlight color for the selected task
-width <n>	display width
-height <n>	display height
-vikunja-server <url>	base URL of your Vikunja instance
-vikunja-token <tok>	Vikunja personal API token

Configuration

Settings are resolved in this order, highest priority last (later ones override earlier ones):

1. Built-in defaults

2. VIKUNJA_SERVER / VIKUNJA_TOKEN environment variables

3. The auto-discovered config file in the OS-standard per-user config directory - created automatically on first run if it doesn't exist yet:

   • Linux: ~/.config/go22dos/config.toml (or $XDG_CONFIG_HOME/go22dos)
   • macOS: ~/Library/Application Support/go22dos/config.toml
   • Windows: %APPDATA%\go22dos\config.toml

   On first run go22dos creates this directory and writes a commented-out template there, so there's always a canonical place to edit settings without needing -config at all

4. An explicit -config <file.toml> flag, if given (loaded on top of the auto-discovered file, so it only needs to contain what you want to override)

5. Individual CLI flags: -vikunja-server, -vikunja-token, -color, -width, -height

Default Key Mapping

key	mapped to	list view	detail view
up / down	j / k	down / up	-
top / bot	t / b	jump to first / last task	-
refresh	r	refresh from Vikunja	-
toggle	Tab/ Enter	open the highlighted task's detail	toggle the task's done state, then back to list
quit	q	quit	-
exit	Esc	-	back to list

For an example of how to configure key mappings see the commented-out config template

Installing & Building

cargo install go22dos 

cargo build --release

Contribution

Feel free to contribute :)

License

MIT