// readme

initech is an agent runtime for directing teams of AI coding agents. Each agent gets its own PTY-backed pane, reliable IPC messaging, and bead-aware state tracking — all in one TUI. Works with Claude Code, Codex, Amp, or any CLI.

Why

Running multiple Claude Code agents in tmux breaks in three specific ways:

  • Messages drop silently. tmux send-keys has no delivery guarantee. When a completion report from eng to super drops, the dispatch chain stalls. initech’s IPC socket confirms delivery or returns an explicit error.
  • Agent state is invisible. A hung agent and a productive one look identical in tmux. initech shows every agent’s activity state simultaneously — active, idle, stalled, or idle-with-work-waiting.
  • Work is invisible to the runtime. tmux doesn’t know what beads exist or who’s working on what. initech parses Claude’s session logs for bead events and surfaces them as typed notifications: green toast when an agent finishes, yellow when it stalls, red when it’s error-looping.

Quick Start

# Install
brew tap nmelo/tap && brew install initech

# Bootstrap a new project
mkdir myproject && cd myproject
initech init

# Launch
initech
```…