Overview
Thegizzi tasks command is a lightweight, local task queue for tracking work from the terminal. It stores tasks in ~/.config/gizzi/tasks.json and supports creating, listing, starting, cancelling, and deleting tasks without leaving the CLI.
Use it to:
- Queue ad-hoc work items alongside an agent session
- Track progress on long-running jobs
- Clean up completed or stale tasks
Command reference
The default subcommand is
list, so gizzi tasks is equivalent to gizzi tasks list.
Task statuses
Tasks move through one of the following statuses:Usage examples
List tasks
Create a task
create becomes the task name.
Show task details
Start and cancel tasks
Delete a task
Clean up old tasks
Task storage
Tasks are persisted to:id, name, optional description, status, progress percentage (0–100), and timestamps for creation, start, and completion.
Common flags
gizzi tasks does not define command-line flags. All behavior is controlled through subcommands and positional arguments.