Subtask

Subtask is an open-source CLI agent harness and orchestration tool developed by zippoxer in Go. It is built to coordinate and decompose coding tasks across developer workflows and external AI coding assistants, providing structured task dispatching and state management from the terminal. Operating directly as a command-line utility, Subtask integrates with Claude-based workflows and plugin ecosystems (such as `.claude-plugin` extensions and custom commands). It manages concurrent task execution, handles signal interruption cleanly, and isolates state transitions during multi-step coding, refactoring, and code review operations. Subtask distinguishes itself through its tight orchestration semantics, providing native concurrency guards, asynchronous revert handling, and targeted subtask isolation. Instead of acting purely as a monolithic conversation wrapper, it provides atomic command-level workflows designed to split complex dev operations into discrete, manageable steps. Subtask is distributed as an open-source tool on GitHub under standard software licensing terms. It supports binary distribution through package managers like Homebrew and manual compilation via the Go toolchain.

Tags: ai agent, cli, code assistant, coding agent, developer tools, OpenSource

Visit Subtask

Key features

  • Subtask Decomposition — Splits complex engineering operations into isolated, trackable subordinate tasks. - Claude Ecosystem Integration — Features native support for .claude-plugin commands and Claude-based workflow tooling. - Concurrency Guards & Reversion — Implements asynchronous revert mechanisms and concurrency protection during task execution. - CLI-First Architecture — Written in Go for fast execution and minimal terminal overhead without heavy dependencies. - Signal Handling & State Isolation — Gracefully manages SIGINT interrupts during active operations and isolates state between sends.

Use cases

Use Case: Coordinated Code Review Workflows Developers can leverage Subtask to break large review and refactoring processes into structured, isolated steps (such as review/async-revert), ensuring task tracking is maintained across commits and branches.

Use Case: Scripted Claude Command Automation Engineering teams using Claude CLI plugins can invoke Subtask to orchestrate custom interactive release pipelines, automated semver bumps, and beta prereleases from the command line.

Use Case: Safe Concurrent Task Orchestration Developers managing long-running agent tasks can trigger operations with built-in concurrency guards, preventing state corruption during interruptions or overlapping send events.

Who it is for

Subtask is aimed at Go developers, CLI enthusiasts, and teams utilizing Claude agent plugins who need granular task isolation and execution control in their terminal workflows. It is less suited for users looking for an all-in-one GUI IDE or non-technical end users who prefer browser-based AI chats.

Install guide

Installation Install via Homebrew (standard for distribution releases) or build directly from source using the Go toolchain: bash # Build from source using Go git clone https://github.com/zippoxer/subtask.git cd subtask go build -o subtask ./cmd/...

First Run Run the install guide to configure plugin markers and verify your local Claude plugin environment: bash subtask install --guide Ensure any required Claude environment variables or API keys are exported in your shell: bash export ANTHROPIC_API_KEY="your-api-key"

Example Session Run a review subtask with isolated state handling: bash subtask send "Review the error handling in pkg/concurrency and create a patch"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Plandex — Plandex is an open-source terminal-based AI coding agent designed to handle complex, multi-file engineering tasks in large codebases. Created by…
  • OpenCode — OpenCode is an open-source AI coding agent developed by Anomaly that operates across terminal environments, desktop applications, and IDE extensions.…
  • OpenHands — OpenHands (formerly OpenDevin) is an open-source autonomous AI software development agent and orchestration platform. It provides an extensible runtime environment…
  • Open Code Review — Open Code Review is an open-source code review orchestration tool and agent plugin suite developed by Alibaba. Built primarily in…
  • EchoCoding — EchoCoding is an open-source agent harness and audio-augmented developer tooling layer created by launsion-boop. Designed to run alongside AI coding…
  • pi-reflect — pi-reflect is an open-source agent harness and self-improvement extension for pi coding agents, developed by jo-inc. It inspects agent session…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories