tqu – A Minimal CLI for Queue-Based Task Tracking

Published on 2025-03-03
Demo for tqu CLI tool

I built a simple CLI tool called tqu to match my workflow for tracking tasks and todos.

Previously, I kept tasks grouped in a single text file, adding tasks to the right group whenever they came to mind, and deleting them once completed. I intentionally avoided features like priorities, due dates, or statuses because I found them distracting.

This CLI tool improves my workflow by storing tasks in a SQLite database. Now I don’t have to manually edit text files, delete tasks, or explicitly create new task groups. Instead, tasks are marked as completed by setting a completion timestamp, effectively hiding them from view. New queues (task groups) are created automatically on the fly.

It can be easily installed by running:

uv tool install tqu
# or
pipx install tqu

Using it is straightforward. Here are some common commands:

# Add a task to the "bills" queue
tqu add "pay electricity bill" bills

# Complete (remove) the most recently added task from "bills"
tqu pop bills

# List all tasks in the "bills" queue
tqu list bills

# Delete a specific task by its ID
tqu delete <task-id>

Let me know if you find this tool useful. I’d love to hear your feedback or suggestions!