Documentation

Everything you need to run a team of AI coding agents from one terminal.

Start Here

*

Getting started

Install initech, bootstrap a project, and launch your first multi-agent session in five minutes.

*

Configuration

Complete initech.yaml reference. Every field, default, and override.

Reference

Commands

All CLI commands with usage, flags, and examples.

TUI

Keybindings, layouts, command modal, and mouse support.

Concepts

Roles

The 11 built-in agent roles, permission tiers, and how to customize them.

Communication

Agent-to-agent messaging with delivery guarantees. send, peek, and patrol.

Cross-machine

Run agents on remote machines. One TUI, multiple hosts.

Web companion

Browser-based TUI mirror. Live xterm.js terminal streaming over WebSocket.

MCP

MCP server for external tool integration. Drive agents from Cursor, VS Code, or another Claude session.

Beads

Optional integration with the beads issue tracker for work coordination.

Troubleshooting

Common issues, diagnostics with initech doctor, and where to get help.