Project Setup

# Initialize a new project with TaskGraph structure
taskgraph init

# Import a Task Master project (.taskmaster/) into .taskgraph/
taskgraph init --from-taskmaster

# Skip the Claude Code integration (CLAUDE.md import)
taskgraph init --no-claude

# Also register the MCP server in the project's .mcp.json
taskgraph init --mcp

# Only set up Git to merge tasks.json and archive.json by task
# (existing projects; once per clone, and again after upgrading)
taskgraph init --merge-driver

# List all tags with task counts and status
taskgraph tags

# List tags with detailed metadata
taskgraph tags --show-metadata

# Create a new empty tag, optionally with a description
taskgraph tags add <tag-name>
taskgraph tags add <tag-name> --description="Feature development tasks"

# Create a tag named after the current branch
taskgraph tags add <tag-name> --from-branch

# Create a tag by copying tasks from another tag
taskgraph tags add <new-tag> --copy-from=<source-tag>

# Switch to a different tag
taskgraph tags use <tag-name>

# Rename or copy a tag
taskgraph tags rename <old-name> <new-name>
taskgraph tags copy <source-tag> <target-tag>

# Delete a tag and all its tasks (asks for confirmation unless --yes)
taskgraph tags remove <tag-name> --yes

# View the current model configuration
taskgraph models

# Set the main, research and fallback models (opus, sonnet or haiku)
taskgraph models --set-main sonnet
taskgraph models --set-research opus
taskgraph models --set-fallback haiku

# Run interactive setup
taskgraph models --setup

# Set it up for your shell (detected from $SHELL)
taskgraph completion --install

# Or name the shell
taskgraph completion fish --install

# Work through the backlog, one iteration per pending task
taskgraph loop

# Stop after 10 iterations
taskgraph loop -n 10

# Work on one task (1 iteration unless -n is given)
taskgraph loop --id 3

# Build a task test-first: a failing test, the code, a commit, per subtask
taskgraph loop --id 3 --prompt tdd

# Use a specific preset
taskgraph loop -n 10 --prompt test-coverage
taskgraph loop -n 10 --prompt linting
taskgraph loop -n 10 --prompt duplication
taskgraph loop -n 10 --prompt entropy

# Use a custom prompt file
taskgraph loop -n 10 --prompt ./my-workflow.md

# Filter to tasks with a specific tag
taskgraph loop -n 10 --tag backend

# Custom progress file location
taskgraph loop -n 10 --progress-file ./my-progress.txt