This is a simple terminal user interface for vikunja. The purpose is to allow users to manage tasks from the terminal, using their own API key. This project is not managed or affiliated with the Vikunja team.
cargo install vikunja-tui
Place the following two values in a .toml
file within your configuration files under the vikunja-tui
directory. The instance url should not contain api/v1
, just the base url for your instance. The api key just needs read and write access to tasks.
~/.config/vikunja-tui/config.toml
['vikunja']
instance_url = "https://example.com"
api_key = "<your-key-here>"
- View current tasks, with the ability to get details for any given task
- Toggle between showing complete tasks and incomplete tasks (shows incomplete by default)
- Pagination of tasks.
- Add tasks
- Title
- Priority, via ![1-5] (vikunja quick add magic syntax)
- Description, via a seperate input box during task creation
- Parse labels via
*label
- Edit existing tasks