Subtask ✨

Subtask gives Claude Code a Skill and CLI to create tasks, spawn subagents, track progress, review and request changes.

• Each task gets a Git worktree, so they can be done in parallel safely
• Claude can interrupt and talk with subagents!
• TUI shows progress, diffs & conversations
• Tasks are persisted in folders
• Codex subagents supported
• Ralph not needed

Spawning Tasks

You: fix the auth bug and add API metrics with Subtask

Claude:
  ├─► Skill(Subtask)
  ├─► Bash(subtask draft fix/auth-bug ...)
  ├─► Bash(subtask draft feat/api-metrics ...)
  └─⏺ Tasks are in progress! I'll get notified when they're done.

Tracking & Merging

You: which tasks are open?

Claude:
  ├─► Bash(subtask list)
  │   ┌──────────────────┬─────────┬────────────────────────┐
  │   │ TASK             │ STATUS  │ TITLE                  │
  │   ├──────────────────┼─────────┼────────────────────────┤
  │   │ fix/auth-bug     │ replied │ Fix auth token refresh │
  │   │ feat/api-metrics │ working │ Add API metrics        │
  │   │ feat/ui-redesign │ draft   │ Redesign dashboard     │
  │   └──────────────────┴─────────┴────────────────────────┘
  │
  └─⏺ ui-redesign hasn't started yet — want me to kick it off?

You: lets merge fix/auth-bug.

TUI

Run subtask in your terminal to see everything:

Setup

[!NOTE] Subtask is in early development. Upcoming releases will simplify installation, solve known bugs, and improve Claude's proficiency.

Install the CLI

Mac/Linux

curl -fsSL https://subtask.dev/install.sh | bash