Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

tt mission

Autonomous multi-issue mission mode commands.

Synopsis

tt mission start [OPTIONS]
tt mission status [OPTIONS]
tt mission resume <RUN_ID>
tt mission stop <RUN_ID> [OPTIONS]
tt mission list [OPTIONS]

Description

Mission mode enables durable, dependency-aware orchestration of multiple GitHub issues with automatic PR/CI monitoring. Use these commands to start, monitor, and control missions.

Subcommands

tt mission start

Start a new mission with one or more objectives.

tt mission start --issue <ISSUE>... [--doc <PATH>...] [OPTIONS]

Options:

OptionShortDescription
--issue <ISSUE>-iGitHub issue number or URL (repeatable)
--doc <PATH>-dDocument path as objective (repeatable)
--max-parallel <N>Max parallel work items (default: 2)
--no-reviewerDisable reviewer requirement

Issue Formats:

  • 23 — Issue #23 in current repo
  • owner/repo#23 — Fully qualified issue
  • https://github.com/owner/repo/issues/23 — Full URL

Examples:

# Start with single issue
tt mission start --issue 23

# Multiple issues
tt mission start -i 23 -i 24 -i 25

# Cross-repo issues
tt mission start --issue my-org/other-repo#42

# Include a design doc
tt mission start --issue 23 --doc docs/design.md

# Allow more parallelism
tt mission start -i 23 -i 24 --max-parallel 4

# Skip reviewer gate
tt mission start -i 23 --no-reviewer

tt mission status

Show status of missions.

tt mission status [--run <ID>] [--work] [--watch]

Options:

OptionShortDescription
--run <ID>-rShow specific mission by ID
--workShow detailed work item status
--watchShow watch items (PR/CI monitors)

Examples:

# Show all active missions
tt mission status

# Specific mission with work items
tt mission status --run abc123 --work

# Include watch items
tt mission status -r abc123 --work --watch

Output:

🎯 Mission Status
   ID: abc123-def456-...
   State: 🚀 Running
   Created: 2024-01-15 10:30:00 UTC
   Updated: 2024-01-15 11:45:00 UTC

📋 Objectives: 3
   - redis-field-engineering/tinytown#23
   - redis-field-engineering/tinytown#24
   - redis-field-engineering/tinytown#25

⚙️  Policy:
   Max parallel: 2
   Reviewer required: true
   Auto-merge: false
   Watch interval: 180s

📦 Work Items: 5
   🔵 ready    Issue #23: Implement auth flow
   🔄 running  Issue #24: Add rate limiting (→ backend)
   ⏳ pending  Issue #25: Write tests

tt mission resume

Resume a stopped or blocked mission.

tt mission resume <RUN_ID>

Examples:

tt mission resume abc123-def456-...

tt mission stop

Stop an active mission.

tt mission stop <RUN_ID> [--force]

Options:

OptionDescription
--forceForce stop without graceful cleanup

Examples:

# Graceful stop (can be resumed)
tt mission stop abc123

# Force stop (cannot be resumed)
tt mission stop abc123 --force

tt mission list

List all missions.

tt mission list [--all]

Options:

OptionDescription
--allInclude completed/failed missions

Examples:

# Active missions only
tt mission list

# All missions including completed
tt mission list --all

Work Item States

StateEmojiDescription
PendingWaiting for dependencies
Ready🔵Dependencies satisfied, can be assigned
Assigned📌Assigned to an agent
Running🔄Agent is actively working
Blocked🚧Waiting on external event
DoneCompleted successfully

See Also