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:

Install

Note

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

Get the CLI

Mac/Linux

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

Windows (PowerShell)

irm https://subtask.dev/install.ps1 | iex

Other install methods…

Homebrew

brew install zippoxer/tap/subtask

Go

go install github.com/zippoxer/subtask/cmd/subtask@latest

Binary

GitHub Releases

Install the Claude Code Skill

subtask install

# Tip: Uninstall later with `subtask uninstall`.

This asks whether to install to user-scope (~/.claude/skills) or project-scope.

You can skip installing the plugin, it isn't working yet.

Restart Claude Code.

Setup Subtask in your Repo

cd your-repo
subtask init

Use

Talk with Claude Code about what you want done, and then ask it to use Subtask.

Examples:

• "fix the login bug with Subtask"
• "lets do these 3 features with Subtask"
• "plan and implement the new API endpoint with Subtask"

What happens next:

1. Claude Code creates tasks and runs subagents to do them simultaneously.
   
2. Claude gets notified when they're done, and reviews the code.
   
3. Claude asks if you want to merge, or ask for changes.

Updating

subtask update --check
subtask update

Subtask is Built with Subtask

• I use Claude Code to lead the development (i talk, it creates tasks and tracks everything)
• I use Codex for subagents (just preference, Claude Code works too)
• ~60 tasks merged in the past week
• Proof: https://github.com/user-attachments/assets/6c71e34f-b3c6-4372-ac25-dd3eea15932e

License

MIT