Skip to content

tomdringer/tasku

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tasku

タスクリスト — a beautiful terminal task manager.

Colour-coded priorities, status tracking, SQLite persistence, and a clean CLI interface.

Requirements

Ruby >= 3.1.0. Check your version:

ruby --version

If you need to install or upgrade Ruby, use rbenv or asdf:

# with rbenv
rbenv install 3.4.0
rbenv global 3.4.0

# with asdf
asdf install ruby 3.4.0
asdf global ruby 3.4.0

Installation

gem install tasku

Usage

Run tasku followed by a command:

tasku add              Create a new task
tasku list             List all tasks
tasku show ID          Show task details
tasku edit ID          Edit a task
tasku done ID          Mark a task as done
tasku delete ID        Delete a task
tasku stats            Show task statistics
tasku projects         List all projects
tasku categories       List all categories
tasku version          Show version

Adding a task

tasku add --name "Write docs" --priority high --due 2026-07-15

Or use interactive mode:

tasku add -i

Listing tasks

tasku list                          # all tasks
tasku list --status todo            # filter by status
tasku list --priority high          # filter by priority
tasku list --project "MyApp"        # filter by project
tasku list --overdue                # overdue tasks only
tasku list --sort due --order desc  # sorted

Editing a task

tasku edit 1 --name "New name" --priority urgent
tasku edit 1 --clear tags,hours

Valid values

Field Values
Priority none, low, medium, high, urgent
Status backlog, todo, in_progress, done, cancelled, archived

Raw SQL

tasku --sql "SELECT * FROM tasks WHERE priority = 'high'"

Development

git clone https://github.com/tomdringer/tasku.git
cd tasku
bundle install
ruby -Ilib exe/tasku list

License

MIT

About

Terminal based task manager

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages