init-agents

What problem does it solve?

It solves the problem of unreliable, misrouted multi-agent communication by standardizing how a controller discovers tmux panes, clears or preserves sessions safely, and sends correct handoff prompts to the right agent types.

Core Features & Use Cases

• Agent routing map: Selects the right agent (Claude Code vs Codex) for review or implementation/fix work so prompts match expected capabilities.
• Tmux pane discovery and targeting: Forces two-step discovery to obtain the correct full pane id before any send/wait/capture actions.
• Safe session management: Uses clear only for new tasks and avoids clearing when the target pane is mid-assignment to prevent losing context.
• Prompt formatting safeguards: Prevents tmux-send truncation by avoiding bare issue/PR number patterns like #45 and using safer alternatives.
• Role-scoped handoff checklist: Ensures prompts include gate/scope/artifact/stop-condition and prohibits unintended commits, pushes, PRs, or gate transitions unless authorized.

Quick Start

Use init-agents to initialize the controller session so it can discover tmux panes for AgentMiMo, AgentDS, AgentGLM, AgentOpus, and AgentCodex and reliably dispatch review and implementation/fix handoffs.