Show HN：Relaymux —— 一個基於 tmux 的本地編碼代理元操控工具

Relaymux 是一個創新性的輕量級本地元操控工具，專為編碼代理設計。它的核心理念是將 Telegram 作為遠端控制器，而 tmux 則提供可見、可恢復的本地工作環境。與許多隱藏代理執行細節的工具不同，Relaymux 啟動代理時會在你的機器上開啟一個可見的 tmux 視窗，讓你可以像對待普通終端會話一樣附加、觀察、中斷或除錯代理的執行。

安裝與設定

使用 Relaymux 非常簡單。你只需要 Node.js 20+、npm、tmux 以及一個本地代理 CLI（如 pi、codex 或 claude）。安裝命令只需一行 curl 命令：

curl -fsSL https://raw.githubusercontent.com/mupt-ai/relaymux/main/install.sh | bash

該安裝程式會下載原始碼壓縮包，在本地構建 Relaymux，並將 CLI 封裝寫入 PATH 目錄。無需克隆整個倉庫。

設定 Telegram 機器人同樣簡潔：使用 BotFather 建立機器人後，執行 relaymux setup --telegram --telegram-bot-token ''，然後在 Telegram 中向機器人傳送 /start，Relaymux 會自動儲存令牌、發現你的聊天 ID 並啟動後臺服務。

使用方法

使用 Relaymux 時，只需向你的 Telegram 機器人傳送類似“在 ~/code/my-app 中開啟代理並檢查失敗的測試”的訊息。Relaymux 會將訊息傳遞給你的本地協調器，如果協調器啟動代理，該代理會在 tmux 中執行，最終回覆會透過 Telegram 返回。

tmux 工作空間

Relaymux 預設使用一個名為“agents”的共享 tmux 會話。每個啟動的代理都有自己的 tmux 視窗。你可以隨時透過 tmux attach -t agents 附加到會話，使用 Ctrl-b d 分離。關閉 Telegram 不會停止 tmux 執行。

其他功能

除了 Telegram，Relaymux 還提供 iMessage/SMS 測試版支援（需要本地 imsg 命令）。故障排除命令包括 relaymux doctor、relaymux status-launch-agent 和 relaymux status --history。日誌儲存在 ~/.relaymux/logs，配置檔案在 ~/.relaymux/config.json。

總之，Relaymux 是一個輕量級、高度透明的工具，適合那些希望遠端控制編碼代理同時保持完全可見性和控制權的開發者。