tt task

Manage individual tasks.

Synopsis

tt task <SUBCOMMAND> [OPTIONS]

Description

Provides operations for managing specific tasks by ID: completing, viewing details, or listing tasks.

Subcommands

Complete

Mark a task as completed:

tt task complete <TASK_ID> [--result <MESSAGE>]

Show

View details of a specific task:

tt task show <TASK_ID>

List

List all tasks with optional filtering:

tt task list [--state <STATE>]

States: pending, assigned, running, completed, failed, cancelled

Options

Examples

Mark a Task Complete

tt task complete 550e8400-e29b-41d4-a716-446655440000 --result "Fixed the bug"

Output:

✅ Task 550e8400-e29b-41d4-a716-446655440000 marked as completed
   Description: Fix authentication bug
   Result: Fixed the bug

View Task Details

tt task show 550e8400-e29b-41d4-a716-446655440000

Output:

📋 Task: 550e8400-e29b-41d4-a716-446655440000
   Description: Fix authentication bug
   State: Running
   Assigned to: backend-1
   Created: 2025-03-09T12:00:00Z
   Updated: 2025-03-09T12:05:00Z
   Started: 2025-03-09T12:01:00Z
   Tags: backend, auth

List Running Tasks

tt task list --state running

Output:

📋 Tasks (2):
   🔄 550e8400-... - Fix authentication bug [backend-1]
   🔄 660e9500-... - Update API endpoints [backend-2]

List All Tasks

tt task list

State icons:

• ⏳ Pending
• 📌 Assigned
• 🔄 Running
• ✅ Completed
• ❌ Failed
• 🚫 Cancelled

See Also

• tt tasks — Overview of pending tasks
• tt assign — Assign new tasks
• tt backlog — Manage unassigned tasks