{"id":47678506,"url":"https://github.com/nmelo/initech","last_synced_at":"2026-05-21T01:13:52.666Z","repository":{"id":346931541,"uuid":"1158692011","full_name":"nmelo/initech","owner":"nmelo","description":"An agent runtime for agents who collaborate with each other from one terminal. Optimized for steerability.","archived":false,"fork":false,"pushed_at":"2026-05-09T21:14:14.000Z","size":20095,"stargazers_count":23,"open_issues_count":5,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-09T21:26:54.472Z","etag":null,"topics":["ai-agents","beads","claude-code","multiplexer","tmux","tui"],"latest_commit_sha":null,"homepage":"https://initech.sh/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nmelo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"nmelo"}},"created_at":"2026-02-15T19:17:04.000Z","updated_at":"2026-05-09T21:14:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nmelo/initech","commit_stats":null,"previous_names":["nmelo/initech"],"tags_count":285,"template":false,"template_full_name":null,"purl":"pkg:github/nmelo/initech","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmelo%2Finitech","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmelo%2Finitech/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmelo%2Finitech/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmelo%2Finitech/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nmelo","download_url":"https://codeload.github.com/nmelo/initech/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmelo%2Finitech/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33086877,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","beads","claude-code","multiplexer","tmux","tui"],"created_at":"2026-04-02T13:41:37.291Z","updated_at":"2026-05-16T01:09:52.477Z","avatar_url":"https://github.com/nmelo.png","language":"Go","funding_links":["https://github.com/sponsors/nmelo"],"categories":[],"sub_categories":[],"readme":"[![Go](https://img.shields.io/badge/Go-1.25-00ADD8?logo=go\u0026logoColor=white)](https://go.dev)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Coverage](https://img.shields.io/badge/coverage-71.5%25-yellowgreen)](https://github.com/nmelo/initech)\n[![Homebrew](https://img.shields.io/badge/brew-nmelo%2Ftap-orange?logo=homebrew)](https://github.com/nmelo/homebrew-tap)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/nmelo/initech)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/hero.jpg\" alt=\"initech — run a fleet of Claude Code agents from one terminal\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cstrong\u003eNo tmux required!!\u003c/strong\u003e\n\n**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.\n\n## Why\n\nRunning multiple Claude Code agents in tmux breaks in three specific ways:\n\n- **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.\n- **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.\n- **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.\n\n## Quick Start\n\n```bash\n# Install\nbrew tap nmelo/tap \u0026\u0026 brew install initech\n\n# Bootstrap a new project\nmkdir myproject \u0026\u0026 cd myproject\ninitech init\n\n# Launch\ninitech\n```\n\n`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.\n\n`initech` (no subcommand) launches the TUI. All agent panes start simultaneously.\n\n\u003cp align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/20a30a27-ea82-40e7-8f64-ee5a2adf2252\" autoplay loop muted playsinline controls width=\"100%\"\u003e\u003c/video\u003e\n\u003c/p\u003e\n\n## Features\n\n- **Full PTY emulation** — each agent runs in a real terminal with VT100 support\n- **Reliable IPC** — `initech send eng1 \"message\"` delivers or errors; no silent drops\n- **Activity detection** — tracks byte flow per agent; idle-at-prompt is the only zero-output state\n- **Bead integration** — parses Claude's JSONL session logs for `bd` commands; shows assignments in the ribbon\n- **Toast notifications** — work state changes surface automatically, no agent cooperation required\n- **Cross-machine support** — run agents across multiple machines; remote panes stream live over TCP\n- **13 role templates** — super, pm, arch, eng, qa, shipper, sec, pmm, writer, ops, growth, and more\n- **Any CLI per role** — run Claude Code, Codex, Amp, or any CLI side by side via `role_overrides` in `initech.yaml`\n- **Command modal** — layout control, agent restart, patrol view, activity monitor, all from one bar\n\n## Command Reference\n\n```bash\ninitech send \u003crole\u003e \"message\"    # Deliver text to an agent\ninitech peek \u003crole\u003e [-n lines]   # Read agent terminal output\ninitech patrol                   # All agents' output in one call\ninitech status                   # Agent table: activity, bead, alive\ninitech restart \u003crole\u003e           # Kill and respawn an agent\ninitech serve                    # Run headless daemon for remote connections\ninitech peers                    # List connected machines and their agents\ninitech standup                  # Morning standup from beads\ninitech doctor                   # Check prerequisites\n```\n\nFull CLI reference, configuration options, role catalog, and cross-machine setup: **[Operator Guide](docs/operator-guide.md)**\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/stapler.png\" alt=\"I believe you have my stapler\" width=\"200\"\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmelo%2Finitech","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnmelo%2Finitech","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmelo%2Finitech/lists"}