Relaymux uses tmux to orchestrate local CLI coding agents
Relaymux is a lightweight, tmux-based meta-harness for running and tracking local CLI coding agents, using Telegram or iMessage for notifications instead of a dedicated frontend.
Score breakdown
Relaymux removes the need for a dedicated orchestration framework or special non-interactive agent mode by routing coordination entirely through tmux sessions and consumer messaging apps.
- 01Relaymux is a tmux-based meta-harness for running and tracking local CLI coding agents.
- 02The harness owns the tmux session; each task gets its own named tmux window or tab.
- 03Subagents run as normal interactive CLI processes, optionally in their own git worktrees.
Relaymux, posted to Hacker News by byhong03, is a tmux-based meta-harness designed for running and tracking local CLI coding agents with minimal orchestration overhead. The author describes existing tools — Conductor, cmux, and the native Codex and Claude Code apps — as already capable, but finds the orchestration layer in those tools overengineered for personal use. Relaymux is framed as an opinionated, simpler alternative, targeting a local setup (described as a Raspberry Pi use case) where the user wants to stay in control without a heavy framework.
The core design keeps the frontend as Telegram, iMessage, or a plain CLI, with tmux serving as the visibility layer when deeper inspection is needed.
The core design keeps the frontend as Telegram, iMessage, or a plain CLI, with tmux serving as the visibility layer when deeper inspection is needed. The harness owns the tmux session, and each task becomes a named tab or window. Subagents are standard interactive CLI agents — potentially running in their own git worktrees — that report back to the orchestrator via CLI when they are blocked or done, triggering a Telegram or iMessage notification to the user. Because Relaymux works with any CLI agent that supports an interactive terminal mode, it avoids dependence on special non-interactive or print modes, sidestepping Agent SDK and `claude -p` billing limitations.
Key facts
- 01Relaymux is a tmux-based meta-harness for running and tracking local CLI coding agents.
- 02The harness owns the tmux session; each task gets its own named tmux window or tab.
- 03Subagents run as normal interactive CLI processes, optionally in their own git worktrees.
- 04Subagents report back to the orchestrator via CLI when blocked or done.
- 05The user-facing frontend is Telegram, iMessage, or a plain CLI — not a dedicated UI.
- 06Works with any CLI agent that has an interactive terminal mode, avoiding Agent SDK and `claude -p` billing limitations.
- 07The author cites Conductor, cmux, and native Codex/Claude Code apps as existing alternatives.
Topics
Summary and scoring are generated automatically from the original article. We always link back to the publisher and never republish images or paywalled content. Last processed Jun 18, 2026 · 10:40 UTC. How this works →