Skip to content
Back to search

subtask

Claude Skill to do your tasks with subagents in Git worktrees

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zippoxer--subtask/badge.svg)](/listings/zippoxer--subtask)

HTML

<a href="/listings/zippoxer--subtask"><img src="/api/listings/zippoxer--subtask/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

> [!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

Windows (PowerShell)

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

<details> <summary>Other install methods…</summary>

Homebrew

brew install zippoxer/tap/subtask

Go

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

Binary

[GitHub Releases](https://github.com/zippoxer/subtask/releases)

</details>

Install the Skill

Tell Claude Code:

Setup Subtask with `subtask install --guide`.

Claude will install the Subtask skill at `~/.claude/skills`, and ask you whether subagents should run Claude, Codex or OpenCode.

<details> <summary>Or install manually…</summary>

subtask install

# Tip: Uninstall later with `subtask uninstall`.

</details>

Install the Plugin (Optional)

In Claude Code:

/plugin marketplace add zippoxer/subtask
/plugin install subtask@subtask

This reminds Claude to use the Subtask skill when it invokes the CLI.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "subtask",
  3. "owner": {
  4. "name": "zippoxer"
  5. },
  6. "metadata": {
  7. "description": "Parallel task orchestration for AI coding agents"
  8. },
  9. "plugins": [
  10. {
  11. "name": "subtask",
  12. "source": "./plugin",
  13. "description": "Dispatch work to parallel Codex workers in isolated git workspaces",
  14. "version": "1.0.0",
  15. "repository": "https://github.com/zippoxer/subtask",
  16. "license": "MIT",
  17. "keywords": ["orchestration", "parallel", "codex", "tasks", "git-worktrees"]
  18. }
  19. ]
  20. }
README.md · README · 149 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Subtask ✨
  2. Subtask gives Claude Code a Skill and CLI to create tasks, spawn subagents, track progress, review and request changes.
  3. * Each task gets a Git worktree, so they can be **done in parallel** safely
  4. * **Claude can interrupt and talk with subagents**!
  5. * TUI shows progress, diffs & conversations
  6. * Tasks are persisted in folders
  7. * Codex subagents supported
  8. * Ralph not needed
  9. ### Spawning Tasks
  10. ```makefile
  11. You: fix the auth bug and add API metrics with Subtask
  12. Claude:
  13. ├─► Skill(Subtask)
  14. ├─► Bash(subtask draft fix/auth-bug ...)
  15. ├─► Bash(subtask draft feat/api-metrics ...)
  16. └─⏺ Tasks are in progress! I'll get notified when they're done.
  17. ```
  18. ### Tracking & Merging
  19. ```makefile
  20. You: which tasks are open?
  21. Claude:
  22. ├─► Bash(subtask list)
  23. │ ┌──────────────────┬─────────┬────────────────────────┐
  24. │ │ TASK │ STATUS │ TITLE │
  25. │ ├──────────────────┼─────────┼────────────────────────┤
  26. │ │ fix/auth-bug │ replied │ Fix auth token refresh │
  27. │ │ feat/api-metrics │ working │ Add API metrics │
  28. │ │ feat/ui-redesign │ draft │ Redesign dashboard │
  29. │ └──────────────────┴─────────┴────────────────────────┘
  30. │
  31. └─⏺ ui-redesign hasn't started yet — want me to kick it off?
  32. You: lets merge fix/auth-bug.
  33. ```
  34. ### TUI
  35. Run `subtask` in your terminal to see everything:
  36. <table>
  37. <tr>
  38. <td><img width="983" height="603" alt="image (2)" src="https://github.com/user-attachments/assets/fcc4686a-afa1-4168-b141-e54d9286ad4c" /></td>
  39. <td><img width="985" height="603" alt="image" src="https://github.com/user-attachments/assets/9d6cd9a2-ba80-4e4e-9fdc-fd0f675b124a" />
  40. </td>
  41. </tr>
  42. </table>
  43. ## Setup
  44. > [!NOTE]
  45. > Subtask is in early development. Upcoming releases will simplify installation, solve known bugs, and improve Claude's proficiency.
  46. ### Install the CLI
  47. #### Mac/Linux
  48. ```bash
  49. curl -fsSL https://raw.githubusercontent.com/zippoxer/subtask/main/scripts/install.sh | bash
  50. ```
  51. #### Windows (PowerShell)
  52. ```powershell
  53. irm https://raw.githubusercontent.com/zippoxer/subtask/main/scripts/install.ps1 | iex
  54. ```
  55. <details>
  56. <summary>Other install methods…</summary>
  57. #### Homebrew
  58. ```bash
  59. brew install zippoxer/tap/subtask
  60. ```
  61. #### Go
  62. ```bash
  63. go install github.com/zippoxer/subtask/cmd/subtask@latest
  64. ```
  65. #### Binary
  66. [GitHub Releases](https://github.com/zippoxer/subtask/releases)
  67. </details>
  68. ### Install the Skill
  69. Tell Claude Code:
  70. ```md
  71. Setup Subtask with `subtask install --guide`.
  72. ```
  73. Claude will install the Subtask skill at `~/.claude/skills`, and ask you whether subagents should run Claude, Codex or OpenCode.
  74. <details>
  75. <summary>Or install manually…</summary>
  76. ```bash
  77. subtask install
  78. # Tip: Uninstall later with `subtask uninstall`.
  79. ```
  80. </details>
  81. ### Install the Plugin (Optional)
  82. In Claude Code:
  83. ```
  84. /plugin marketplace add zippoxer/subtask
  85. /plugin install subtask@subtask
  86. ```
  87. This reminds Claude to use the Subtask skill when it invokes the CLI.
  88. ## Use
  89. Talk with Claude Code about what you want done, and then ask it to use Subtask.
  90. Examples:
  91. - `"fix the login bug with Subtask"`
  92. - `"lets do these 3 features with Subtask"`
  93. - `"plan and implement the new API endpoint with Subtask"`
  94. What happens next:
  95. 1. Claude Code creates tasks and runs subagents to do them simultaneously.<br/>
  96. 2. Claude gets notified when they're done, and reviews the code.<br/>
  97. 3. Claude asks if you want to merge, or ask for changes.
  98. ## Updating
  99. ```bash
  100. subtask update --check
  101. subtask update
  102. ```
  103. ## Subtask is Built with Subtask
  104. - I use Claude Code to lead the development (i talk, it creates tasks and tracks everything)
  105. - I use Codex for subagents (just preference, Claude Code works too)
  106. - ~60 tasks merged in the past week
  107. - [Proof](https://github.com/user-attachments/assets/6c71e34f-b3c6-4372-ac25-dd3eea15932e)
  108. ## License
  109. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.