v0.2.0

tasktui

A terminal UI for managing project tasks as plain Markdown files. No databases, no cloud sync, no accounts — tasks live as .md files in your repo, tracked by git alongside your code.

tasktui is built around focus. Instead of an endless backlog, you plan a short ready queue, start one task at a time, and finish it before picking the next.

Install

curl -fsSL https://raw.githubusercontent.com/carlMobileDev/tasktui/main/install.sh | sh

Supports macOS (Apple Silicon & Intel) and Linux (x86_64 & aarch64).

Or download a binary directly from the assets below.

Getting Started

# Initialize in any project directory
cd your-project
tasktui init

# Create some tasks
tasktui add "Set up CI pipeline" --priority p0 --tags "infra,ci"
tasktui add "Write user auth" --priority p1

# Launch the TUI
tasktui

tasktui init creates a .tasktui/ directory with a config.toml, tasks/, and epics/ folder. Each task is a Markdown file with YAML frontmatter — edit them with any text editor, and the TUI picks up changes on reload.

How It Works

Tasks flow through four statuses: inbox → ready → active → done.

The TUI has four views to match, switched with 1–4:

Key	View	What it does
1	Focus	Shows your currently active task with its full description. Mark done (d) or shelve back (s).
2	Pick	Your ready queue. Press Enter to start a task, J/K to reorder.
3	Plan	Inbox triage. Check tasks with Space, then Enter to promote them to ready.
4	Review	Completed tasks grouped by week.

Press ? in any view for the full keybindings reference.

Key Features

• Focus-driven workflow — plan a ready queue, start one task, finish it, pick the next
• Plain Markdown — one .md file per task, git-tracked alongside your code
• Agent Copy (y) — copies rich task context (metadata, related file contents, epic context) to clipboard for AI coding assistants
• Fuzzy search (/), filters (f), and inline task creation (c)
• Editor integration — press e to open any task in $EDITOR
• Due dates with visual overdue/soon indicators

Claude Code Slash Command

tasktui ships with a /prd-to-tasks slash command for Claude Code. Point it at a PRD (Product Requirements Document) and it breaks the document into well-scoped, actionable tasktui tasks — each with a description, acceptance criteria, priority, and tags.

/prd-to-tasks path/to/prd.md

Then open tasktui, go to the Plan view (3), and promote tasks to your ready queue.

What's Changed

• Add README with setup, CLI usage, keybindings, and configuration docs by @carlMobileDev in #1

Full Changelog: https://github.com/carlMobileDev/tasktui/commits/v0.2.0