toolkit/packages/skills/attach-agent-worktree/SKILL.md
Attach to Agent Session
npx skillsauth add stevengonsalvez/agents-in-a-box attach-agent-worktreeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Changes to agent worktree directory and attaches to its tmux session.
/attach-agent-worktree {timestamp}
#!/bin/bash
AGENT_ID="$1"
if [ -z "$AGENT_ID" ]; then
echo "Agent ID required"
echo "Usage: /attach-agent-worktree {timestamp}"
exit 1
fi
# Find worktree directory
WORKTREE_DIR=$(find worktrees -type d -name "agent-${AGENT_ID}*" 2>/dev/null | head -1)
if [ -z "$WORKTREE_DIR" ] || [ ! -d "$WORKTREE_DIR" ]; then
echo "Worktree not found for agent: $AGENT_ID"
exit 1
fi
SESSION="agent-${AGENT_ID}"
# Check if tmux session exists
if ! tmux has-session -t "$SESSION" 2>/dev/null; then
echo "Tmux session not found: $SESSION"
exit 1
fi
echo "Worktree: $WORKTREE_DIR"
echo "Attaching to session: $SESSION"
echo ""
# Attach to session
tmux attach -t "$SESSION"
documentation
Report reflect drain spend over a time window — tokens split by cached (cache_read), uncached writes (cache_creation), and io (input+output), with a $ estimate, grouped by day / outcome / model / transcript. Reads the drainer's cost log and surfaces outlier runs and cache-reuse health (the 41.5M-token failure mode = low cache reuse + high cache writes). Use to answer "what is reflection costing me" for the last day / week.
development
Show fleet status — every claude session running on the host, merged across ainb + claude-peers broker + background jobs. Use when you need to enumerate sessions before composing an action, see which sessions have a peer registered (broker-routable) vs tmux-only, check the `summary` of each session, or pipe the list into jq for filtering. Default output: text table. Pass --format json for LLM consumption.
testing
Ordered multi-step prompts to fleet targets, ack-gated between steps via JSONL assistant-turn-end detection. Use for cycles like disconnect→reconnect→verify, or any flow where step N+1 requires step N to have completed first. The skill BLOCKS until each target's transcript shows the next assistant turn finishing OR per-step timeout fires (default 300s).
development
Center control panel — enumerate every claude session that is blocked waiting on something: a user answer (AskUserQuestion fired), an API error retry, an idle assistant turn-end with no follow-up, or an explicit WAITING: marker. Returns rich JSON with signal kind + context per session. Use this when you've stepped away from the fleet and want one place to see everything that wants your attention and answer it.