BertiKarsunke

Agmsg Cmux Bridge — AI skill for Claude Code

AI community

Bridges CLI AI agents (Claude Code, Codex, Gemini CLI, and more) over local SQLite with tmux/cmux/wezterm turn-mode pane-push — no daemon, no network.

How to install Agmsg Cmux Bridge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open BertiKarsunke/agmsg-cmux-bridge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agmsg Cmux Bridge does

Bridges CLI AI agents (Claude Code, Codex, Gemini CLI, and more) over local SQLite with tmux/cmux/wezterm turn-mode pane-push — no daemon, no network. Fork of fujibee/agmsg.

Alternatives in AI

Agmsg — Cross-vendor messaging for CLI AI coding agents — let Claude Code, Codex, Gemini & Copilot talk to each other 1.5k ★
Oil UI — Push AI UI design to its limits: explore distinct directions, compare them side by side, and refine against re 861 ★
onWatch — Open-source Go CLI that tracks AI API quota usage across 7 providers (Synthetic, Z.ai, Anthropic, Codex, GitHu 397 ★

README

English | [한국어](README.ko.md) | [日本語](README.ja.md)

agmsg-cmux-bridge

Cross-agent messaging for CLI AI agents. No daemon, no network, no complexity.

Summary

agmsg-cmux-bridge is a fork of [fujibee/agmsg](https://github.com/fujibee/agmsg) that bridges CLI AI agents with tmux/cmux/WezTerm/Kaku/herdr turn-mode pane-push: Claude Code, Codex, Gemini CLI, and other agents can message each other through local SQLite without a daemon or network service.

What This Fork Adds

The original agmsg stores and reads messages through local scripts and SQLite. This fork adds best-effort turn-mode pane-push: after `scripts/send.sh` stores a message, it checks whether the recipient has a registered tmux, cmux, WezTerm/Kaku, or herdr pane and injects a short prompt asking that agent to run its agmsg skill and read the inbox.

Pane registrations follow the role lifecycle:

scripts/join.sh tries to register the current pane after the agent joins a team.
For Claude Code, scripts/actas-claim.sh refreshes the registration to the current pane after an actas claim succeeds.
Turn-mode agents such as Codex, Gemini, Copilot, Cursor, OpenCode, Antigravity, and Hermes re-register the current pane with scripts/pane.sh register inside their own actas skill command flow.
scripts/reset.sh, used by reset/drop flows, clears the pane registration for the removed role.

That lets agmsg-cmux-bridge track the live pane for a role as the role joins, switches, and drops.

How It Works

Pane support lives in `scripts/lib/pane.sh` and `scripts/pane.sh`. The backend is detected automatically: tmux uses `$TMUX_PANE` when `$TMUX` and `tmux` are available; cmux uses `cmux identify --json` and its `caller.surface_ref` value, with `$CMUX_SURFACE_ID` as a fallback; WezTerm/Kaku uses `$WEZTERM_PANE` and the `$WEZTERM_UNIX_SOCKET` or `$KAKU_UNIX_SOCKET` socket; herdr uses `$HERDR_PANE_ID` when `$HERDR_ENV=1` (including its configured socket). Herdr supports spawn, nudge, despawn, and