Awesome

Description

tsk allows you to create and manage your tasks efficiently your terminal, so that you can dump your mouse 🖱️

Why

Shiny task management web apps often have tons of unnecessary features causing UI glitches which impact our UX 😵‍💫 <br> The huge JS chunks loading and network calls on every smallest action causing feedback delay and it is annoying ⌛

Personal task management should be as simple as possible, let's build a snappy cli app that doesn't get in our way ✌️

Features

• Simple and concise commands ✅
• Works without internet connection ✅
• Data stored locally - powered by BoltDB ✅
• Task due reminder via desktop notification ✅

See todo

Installation

Homebrew

brew tap kakengloh/tsk
brew install tsk

Go

# Go 1.16+
go install github.com/kakengloh/tsk@latest

# Go < 1.16
GO111MODULE=on go get github.com/kakengloh/tsk

Ensure that $GOPATH/bin is in your PATH

Shell completion

Shell completion is supported on bash, zsh, fish, powershell

To enable it, run tsk completion {YOUR_SHELL} -h and follow the steps

Executables

See releases

Example

Create a new task

tsk new 'make coffee'

Create a new task with status, priority and due

tsk new 'feed my cat' -s doing -p high -d 1h

List tasks

tsk ls

List tasks with filters (status, priority, due)

tsk ls -s doing -p high -d 1h

List tasks with a keyword

tsk ls cat

List tasks as JSON

tsk ls -f json

View tasks in a Kanban board

tsk board

Mark task(s) as todo

tsk todo 2

Mark task(s) as doing

tsk doing 2

Mark task(s) as done

tsk done 2

Modify an existing task

tsk mod 2 -s todo -p low

Add note(s) on a task

tsk note 2 'it still hungry' 'meow...'

Remove task(s)

tsk rm 1

Start task reminder

tsk reminder start

Stop task reminder

tsk reminder stop

Set task reminder time

# Notify on 1 minute, 15 minute and 1 hour before task due
tsk reminder time 1m 15m 1h

Clean your data

tsk clean

Todo

• Task due
• Due reminder (via desktop notification)

Contributing

We welcome all feature requests and pull requests! 🙋