spawn-coding-worker

Spawn specialized coding subagents—coder, tester, or reviewer—powered by Claude, Codex, Gemini, or Kimi via a unified bash wrapper script. Trigger from Claude Code sessions with /spawn-coding-worker or run directly from CLI, generating session logs and markdown result artifacts for streamlined AI-assisted coding workflows.

spawn-coding-worker Plugin

Claude Code plugin package that embeds one mixed-subagent skill.

Included components

.claude-plugin/plugin.json
commands/spawn-coding-worker.md → slash command entry point
skills/spawn-coding-worker/SKILL.md
skills/spawn-coding-worker/scripts/spawn-coding-worker.sh
skills/spawn-coding-worker/scripts/cc_env.sh
skills/spawn-coding-worker/references/spawn-workflow.md

commands/ and skills/spawn-coding-worker/* are symlinks to the shared source at:

../../skills/spawn-coding-worker/

Refresh all links after editing shared source:

./scripts/sync-shared-assets.sh

Purpose

Enable Claude Code main sessions to orchestrate Claude, Codex, Gemini, or Kimi sub-agents through one entrypoint:

/spawn-coding-worker

Use --cli to select runtime (claude, codex, gemini, or kimi).

Installation (Claude Code plugin system)

claude plugin install does not support local paths. Copy manually using cp -rL or rsync -aL to dereference symlinks:

PLUGIN_CACHE=~/.claude/plugins/cache/local/spawn-coding-worker/0.2.0
rm -rf "$PLUGIN_CACHE"
cp -rL /path/to/subagent-skill/plugin/spawn-coding-worker "$PLUGIN_CACHE"

Then add to ~/.claude/plugins/installed_plugins.json and restart Claude Code.

Important: Never use plain cp -r — it copies symlinks as-is, resulting in an empty plugin that silently fails to load.

Verified Smoke Commands

Run from repository root after skill/plugin is loaded.

./scripts/spawn-coding-worker.sh --cli codex --name smoke-codex-joke --type coder --task "Tell a joke."
./scripts/spawn-coding-worker.sh --cli gemini --name smoke-gemini-joke --type coder --task "Tell a joke."
./scripts/spawn-coding-worker.sh --cli kimi --name smoke-kimi-explain --type reviewer --task "Explain what this code does: $(cat main.py)"
env -u CLAUDECODE ./scripts/spawn-coding-worker.sh --cli claude --name smoke-claude-joke --type coder --task "Tell a joke."

Note: The env -u CLAUDECODE prefix is required when spawning Claude workers from within a Claude Code session. This prevents nested session conflicts.