vk

vk is a command line todo tool for Vikunja.

Setup

vk saves it's configuration at $HOME/.config/vk.toml.

To log in to your Vikunja Instance you can either use a API Token which you have to create manually or sign in using:

vk login --username user --password somepass --totp code --host vikunja.example.com

Usage

Show your current todos:

# Just this
vk

# See done tasks as well
vk -d
vk --done

# Show favorites only
vk -f
vk --favorite

# Show tasks from specific project
vk --from myproject

# Show tasks which have a label
vk -l label
vk --label label

Working with tasks:

# Create a task
vk new mytask

# Task Detail View
vk info 42 # Tasks are referenced by their ID

# Remove a task
vk rm 42

# Mark as done
vk done 42

# Assign a user to a task
vk assign me 42
vk assign -u me 42 # You can undo this

Working with projects:

# List your projects
vk prj ls

# Create a new project
vk prj add MyPrj --description "My project"

# Remove a project
vk prj rm MyPrj

Working with labels:

# Assign a label to a task
vk label mylabel 42
vk label -u mylabel 42 # Undo as well

# List your labels
vk labels ls

# Create a new label
vk labels new mylabel

# Remove a label
vk labels rm mylabel