Skip to content

mark-pitblado/vikunja-tui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vikunja-tui

Conventional Commits

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.

Installation

cargo install vikunja-tui

Setup

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>"

Current Features

  • 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

Roadmap

  • Parse labels via *label
  • Edit existing tasks