open-agent-teams

open-agent-teams

Run any CLI agent as an executor inside a detached tmux session. Communication is: prompt in via CLI arg / send-keys, completion out via a file sentinel the agent touches, summary out via a result file the agent writes. File sentinels are used instead of tmux wait-for because a wait-for -S with no waiter is silently lost; files never race and allow timeouts.

All commands via the helper (make sure it runs from the skill dir):

SKILL_DIR/scripts/tdel

Initial setup (once per repo)

If the repo's CLAUDE.md (or AGENT.md) has no delegation rules yet, add the contents of references/CLAUDE.delegation-template.md to it — it defines the coordinator/executor roles and the ROLE: EXECUTOR prompt marker used below.

Workflow

1. Start an agent on a task:

   tdel start <session> "<agent-cmd>" "<prompt>"
   # e.g. tdel start hello "claude --dangerously-skip-permissions" "make a hello world page"
   

   This appends the done-protocol to the prompt automatically (write summary to result file, then touch the done file).

2. Wait for completion — ALWAYS via a background Bash task so you get woken up instead of blocking or polling:

   tdel wait <session> [timeout-sec]     # run with run_in_background: true
   

   Exit 0 = done (prints the agent's summary). Exit 124 = timeout (prints last pane lines for diagnosis). Non-zero also if the session died.

3. Review the output (tdel result <session>, plus inspect the actual files the agent changed). If iteration is needed:

   tdel send <session> "<feedback / next instruction>"
   tdel wait <session>                   # again, run_in_background
   

   Each send is a new turn with its own done/result files — no signal cross-talk between turns.

4. Debug a stuck or slow agent: tdel peek <session> [lines] shows the live pane. tdel status lists all sessions.

5. Stop when finished: tdel stop <session> (kills the session and removes state under /tmp/agent-delegate/<session>).