zelligent-spawn-claude

name	zelligent-spawn-claude
description	Use zelligent CLI to spawn Claude subagents into isolated git worktrees, each opened in a new Zellij tab. Trigger when asked to spawn agents, run parallel Claude instances, or split tasks across separate branches/tabs.
argument-hint	["branch-name task-description ..."]
allowed-tools	Bash(zelligent *)

Use the CLI flow only. Do not use the interactive plugin UI.

Important limitation

• Spawning a sub-agent in a separate Zellij tab does not stream its feedback back into this chat.
• If the user expects review findings or any concrete output in this conversation (for example a code review), do not delegate via zelligent spawn; do the review directly in this agent.

Workflow

1. Work from inside the target git repository.
2. Start or attach to the repo session:

zelligent

3. For each subagent task, choose a branch name and spawn a new tab, embedding the task description as a quoted argument to claude:

zelligent spawn <branch-name> 'claude "<task description for the subagent>"'

The third argument is a single shell-quoted string — the entire claude "..." invocation must be wrapped in outer single quotes so the spawn CLI passes it through verbatim. Without the outer quotes, the prompt is lost and the new tab launches a bare claude with no task.

If the task description itself contains a single quote or $, escape it inside the outer single quotes (e.g. 'claude "it'\''s broken"').

To launch a bare interactive claude with no task, omit the inner string:

zelligent spawn <branch-name> claude

4. Repeat step 3 for additional subagents, one branch per task.

If $ARGUMENTS is provided, parse branch names and task descriptions from it and spawn accordingly, always using the quoted-prompt form above.

Conventions

• Use descriptive branch names, for example agent/fix-auth or agent/write-tests.
• Expect tab names to sanitize / into -:
  • agent/fix-auth becomes tab agent-fix-auth.
• Keep a 1:1 mapping between branch and task.

Cleanup

When a subagent branch is finished, remove its worktree:

zelligent remove <branch-name>

This removes the worktree and keeps the local branch.