initech

command module

v1.15.2 Latest Latest Go to latest Published: Apr 11, 2026 License: MIT Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/nmelo/initech

Links

Open Source Insights

README ¶

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

# 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

initech send <role> "message"    # Deliver text to an agent
initech peek <role> [-n lines]   # Read agent terminal output
initech patrol                   # All agents' output in one call
initech status                   # Agent table: activity, bead, alive
initech restart <role>           # 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

I believe you have my stapler

Documentation ¶

Overview ¶

Package main is the entry point for the initech CLI.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd Package cmd implements the initech CLI commands using Cobra.	Package cmd implements the initech CLI commands using Cobra.
selectortest command selectortest is a manual QA harness for the role selector widget.	selectortest is a manual QA harness for the role selector widget.
internal
color Package color provides ANSI color helpers for CLI output.	Package color provides ANSI color helpers for CLI output.
config Package config owns the initech.yaml schema.	Package config owns the initech.yaml schema.
exec Package exec wraps os/exec with consistent error handling for external command execution.	Package exec wraps os/exec with consistent error handling for external command execution.
git Package git owns git CLI interaction for initech project bootstrap.	Package git owns git CLI interaction for initech project bootstrap.
mcp Package mcp provides an MCP (Model Context Protocol) server for initech, exposing agent primitives over streamable HTTP.	Package mcp provides an MCP (Model Context Protocol) server for initech, exposing agent primitives over streamable HTTP.
roles Package roles owns role definitions, templates, and template rendering for initech projects.	Package roles owns role definitions, templates, and template rendering for initech projects.
scaffold Package scaffold creates the project directory tree on disk from an initech config.	Package scaffold creates the project directory tree on disk from an initech config.
slackchat Package slackchat connects initech to Slack via Socket Mode.	Package slackchat connects initech to Slack via Socket Mode.
tui agents.go implements the agent management modal.	agents.go implements the agent management modal.
update Package update implements background version checking against GitHub Releases with a 24-hour state file cache to avoid redundant API calls.	Package update implements background version checking against GitHub Releases with a 24-hour state file cache to avoid redundant API calls.
web Package web provides an embedded HTTP server for the initech web companion.	Package web provides an embedded HTTP server for the initech web companion.
webhook Package webhook provides a standalone HTTP POST client for sending notifications to a configured webhook URL.	Package webhook provides a standalone HTTP POST client for sending notifications to a configured webhook URL.