claude-agent-worktreeslisted

# Claude Agents And Worktrees Bundled commands use `$PLUGIN_ROOT` (`$env:PLUGIN_ROOT` in PowerShell; same path suffix) for the plugin root. Set it once: use the host's plugin-root variable when defined (Claude Code: `PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"`), otherwise the absolute path of this plugin's root directory. Use this skill for Claude Code session orchestration: background agents, worktrees, tmux/iTerm panes, resumes, PR-linked sessions, forked sessions, session names and IDs, remote control, prompt suggestions, and cloud ultrareview. ## Inspect First Check command surface and current background sessions: ```bash python3 "$PLUGIN_ROOT/scripts/claude_code_inspector.py" --commands agents ultrareview --json claude agents --json ``` Use `claude agents --json --all` only when completed sessions are relevant and the extra transcript/session metadata is needed. ## Background Agents Use `claude agents` for active background session state and dispatch defaults: ```bash claude agents --json claude agents --cwd /path/to/project --json claude agents --model sonnet --permission-mode plan --add-dir /path/to/extra ``` Do not start or leave long-lived background sessions without a reason and a cleanup plan. Use explicit model, permission mode, settings, plugin-dir, and MCP config when reproducibility matters. ## Sessions Use these root flags for session continuity: ```bash claude --continue claude --resume <session-id-or-search> claude --from-pr <pr-number-or-url> claude --f