tasksamurai

module
v0.9.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 2, 2025 License: BSD-2-Clause

README

Task Samurai

tasksamurai logo tasksamurai reaalistic logo

Task Samurai is a fast terminal interface for Taskwarrior written in Go using the Bubble Tea framework. It shows your tasks in a table and lets you manage them without leaving your keyboard.

Why does this exist?

  • I wanted to tinker with agentic coding.
  • I wanted a faster UI for Taskwarrior than other options like vit which is Python based.
  • I wanted something built with Bubble Tea but never had time to deep dive into it.

How it works

Task Samurai invokes the task command to read and modify tasks. The tasks are displayed in a Bubble Tea table where each row represents a task. Hotkeys trigger Taskwarrior commands such as starting, completing or annotating tasks. The UI refreshes automatically after each action so the table is always up to date.

Hotkeys

Press H to view all available hotkeys.

Example: press +, type Buy milk and hit Enter to add a new task called "Buy milk".

Screenshot

Task Samurai screenshot

Installation

There are two ways to install the tasksamurai command:

go install codeberg.org/snonux/tasksamurai/cmd/tasksamurai@latest

Alternatively, clone this repository and run:

go-task install

The second method requires go-task to be installed.

Usage
# Start with default pending tasks
tasksamurai

# Start with a Taskwarrior filter
tasksamurai +tag status:pending
tasksamurai project:work due:today
tasksamurai pri:H

# Any valid Taskwarrior filter can be passed as arguments
Flags
  • --disco: start Task Samurai in disco mode, changing the theme every time a task is modified.

Directories

Path Synopsis
cmd
atable
Package table provides a simple table component for Bubble Tea applications.
Package table provides a simple table component for Bubble Tea applications.
ui

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL