task-master

Task Master

A zero-dependency CLI/TUI Task Manager for developers.

Install

pip install -e .

Quick Start

# Initialize a new task store
task-master init

# Add a task
task-master add "Fix login bug" --priority high --tags "bug,backend"

# Add another
task-master add "Write documentation" --priority low --tags "docs"
task-master add "Refactor auth module" --priority medium --tags "feature,backend"

# List all tasks (color-coded by priority)
task-master list

# Filter by status
task-master list --status pending
task-master list --status done
task-master list --status in-progress

# Start working on a task
task-master start 1

# Mark a task as done
task-master done 1

# View statistics
task-master stats

# Export a markdown report
task-master export report

# Launch the TUI interface
task-master --tui

Commands

Command	Description
task-master init	Create .tasks.json in current dir
task-master add <desc>	Add a new task
task-master list	List all tasks
task-master done <id>	Mark task complete
task-master start <id>	Mark task in progress
task-master stats	Show task statistics
task-master export report	Generate markdown report
task-master --tui	Launch TUI interface

Priority Colors

• High → Red
• Medium → Yellow
• Low → Green

Storage

Tasks are stored in .tasks.json in the current working directory.