majiayu000 Coding Agents
Orchestrate external coding agents programmatically. Use this when you want to delegate tasks to other AI coding tools.
Prefer interactive mode
Interactive sessions via tmux should be the default for most tasks. Background mode is only appropriate for the simplest tasks that require very few commands or edits (e.g., "count the files in src/", "what version of node is this project using?").
Why interactive is better:
- You can observe progress and catch issues early
- You can respond if the agent asks clarifying questions
- You can interrupt if the agent goes off track
- Agents often need multiple turns to complete real work
- Debugging is much easier when you can see what happened
Use background mode only when:
- The task is trivial (one or two simple commands)
- You are confident the agent will complete without interaction
- You are running many parallel tasks and cannot watch them all
Interactive mode requires the tmux Skill
For interactive sessions, you MUST use the tmux Skill. The tmux Skill contains:
- "Orchestrating Claude Code sub-agents" recipe - the primary pattern for this use case
- Socket conventions and session management
- Sending input, monitoring output, cleanup
Read and follow the tmux Skill for all interactive agent orchestration.
For parallel work on multiple issues, use the git worktrees Skill to create isolated branches.
Available agents
Read the relevant reference file for the agent you need right now:
- references/claude-code.md - Anthropic's Claude Code CLI
- references/codex.md - OpenAI's Codex CLI
- references/opencode.md - Open-source coding agent
- references/pi.md - Lightweight multi-provider agent
Each reference includes: invocation, key flags, and completion detection.
Rules
- Respect tool choice - if user asks for Codex, use Codex. Do not offer to do the task yourself.
- Be patient - do not kill sessions because they seem slow. Agents take time.
- Monitor without interfering - check progress but let the agent work.
- Use appropriate flags - permission-bypassing flags for unattended/background work only.
- Isolate work - use worktrees or temp directories to avoid conflicts with your current work.
- Clean up - kill sessions and remove worktrees when done, unless the user asked you not to.