Features

Everything you need to manage tasks without leaving your workflow.

Plain Text Storage

Items are Markdown files you can read, edit, and search with standard tools. No databases, no lock-in.

Scriptable

Every command works non-interactively for automation and CI/CD pipelines. Pipe, filter, and compose with Unix tools.

Interactive TUI

Arrow-key navigation, filter overlay, action menu, and a two-panel wizard for creating items — all in your terminal.

Templates

Create reusable item patterns and instantiate new items from them. Labels, categories, and attachments are inherited.

Attachments

Attach files or URLs to any item. Attachments are stored alongside items and travel with them when archived.

Categories & Labels

Organize items in subdirectories for categories and tag them with labels. Filter and search across both.

Git-Aware

Uses git mv and git rm when available to preserve file history across renames and archives.

Full-Text Search

Search by title, ID, or body content. Partial ID matching lets you reference items with just a few characters.

Install the CLI

Get up and running in seconds.

macOS (Homebrew)

brew tap domzilla/tap
brew install queuestack

Linux / WSL

curl -sL https://github.com/domzilla/queuestack/releases/latest/download/qs-linux-x86_64.tar.gz | tar xz
sudo mv qs-linux-x86_64/bin/qs /usr/local/bin/

From Source (Rust 1.75+)

git clone https://github.com/domzilla/queuestack.git
cd queuestack
cargo install --path .

Post-Install Setup

qs setup  # Configures name, editor, and shell completions (Bash, Zsh, Fish, PowerShell)

Quick Start

A few commands to get you going.

# Initialize a project
qs init

# Create items
qs new "Fix login bug" --label bug
qs new "Add dark mode" --label feature --category enhancements
qs new                                   # Launch the wizard

# List, filter, and search
qs list                                  # Interactive selection
qs list --label bug --sort date          # Filter and sort
qs search "login"                        # Search titles and IDs
qs search "memory" --full-text           # Search body content too

# Update and organize
qs update --id 260109 --title "New title"
qs update --id 26 --label urgent         # Partial ID match

# Attachments
qs attachments add --id 260109 screenshot.png
qs attachments add --id 260109 https://github.com/org/repo/issues/42

# Archive and restore
qs close --id 260109
qs reopen --id 260109

# Templates
qs new "Bug Report" --as-template
qs new "Login Bug" --from-template "Bug Report"

Mac Companion App

A native macOS app that brings all your queuestack projects together in one place.

All Projects in One Place

Browse, search, create, and edit items across projects without touching the terminal. Organize projects into nested groups.

Real-Time Sync

Picks up external changes from the CLI, your editor, or other apps instantly via FSEvents file watching.

Edit in Place

Edit item body, labels, categories, and attachments directly. Preview attachments with Quick Look.

Multi-Window

Open multiple windows with independent state. Built-in auto-updates via Sparkle keep you current.

The app is a thin GUI layer over the qs CLI — your data stays as plain Markdown files, readable by any tool.

Built for Readability

Syntax-highlighted Markdown and color-coded labels make it easy to scan items at a glance.

Queuestack Mac app with syntax-highlighted Markdown body and color-coded labels

Open Source

Queuestack is open source software, licensed under the MIT license.

CLI (Rust) Mac App (Swift)