https://github.com/nmelo/initech
An agent runtime for agents who collaborate with each other from one terminal. Optimized for steerability.
https://github.com/nmelo/initech
ai-agents beads claude-code multiplexer tmux tui
Last synced: 28 days ago
JSON representation
An agent runtime for agents who collaborate with each other from one terminal. Optimized for steerability.
- Host: GitHub
- URL: https://github.com/nmelo/initech
- Owner: nmelo
- License: mit
- Created: 2026-02-15T19:17:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-09T21:14:14.000Z (about 1 month ago)
- Last Synced: 2026-05-09T21:26:54.472Z (about 1 month ago)
- Topics: ai-agents, beads, claude-code, multiplexer, tmux, tui
- Language: Go
- Homepage: https://initech.sh/
- Size: 19.2 MB
- Stars: 23
- Watchers: 1
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://go.dev)
[](https://opensource.org/licenses/MIT)
[](https://github.com/nmelo/initech)
[](https://github.com/nmelo/homebrew-tap)
[](https://deepwiki.com/nmelo/initech)
No tmux required!!
**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
```bash
# Install
brew tap nmelo/tap && brew install initech
# Bootstrap a new project
mkdir myproject && cd myproject
initech init
# Launch
initech
```
`initech init` prompts for a project name, lets you pick roles interactively, and scaffolds the full workspace: `initech.yaml`, agent directories with CLAUDE.md files, git submodules, and project documents.
`initech` (no subcommand) launches the TUI. All agent panes start simultaneously.
## Features
- **Full PTY emulation** — each agent runs in a real terminal with VT100 support
- **Reliable IPC** — `initech send eng1 "message"` delivers or errors; no silent drops
- **Activity detection** — tracks byte flow per agent; idle-at-prompt is the only zero-output state
- **Bead integration** — parses Claude's JSONL session logs for `bd` commands; shows assignments in the ribbon
- **Toast notifications** — work state changes surface automatically, no agent cooperation required
- **Cross-machine support** — run agents across multiple machines; remote panes stream live over TCP
- **13 role templates** — super, pm, arch, eng, qa, shipper, sec, pmm, writer, ops, growth, and more
- **Any CLI per role** — run Claude Code, Codex, Amp, or any CLI side by side via `role_overrides` in `initech.yaml`
- **Command modal** — layout control, agent restart, patrol view, activity monitor, all from one bar
## Command Reference
```bash
initech send "message" # Deliver text to an agent
initech peek [-n lines] # Read agent terminal output
initech patrol # All agents' output in one call
initech status # Agent table: activity, bead, alive
initech restart # Kill and respawn an agent
initech serve # Run headless daemon for remote connections
initech peers # List connected machines and their agents
initech standup # Morning standup from beads
initech doctor # Check prerequisites
```
Full CLI reference, configuration options, role catalog, and cross-machine setup: **[Operator Guide](docs/operator-guide.md)**
---
