Coordinate peer CLI agents with agmsg
Let Claude Code, Codex, Gemini CLI, Copilot CLI, and other terminal agents exchange messages through a shared local SQLite channel.
Prerequisites
bash, sqlite3, agmsg scripts, Claude Code/Codex/Gemini CLI/Copilot CLI/Antigravity/OpenCode as applicable
Installation
Use the upstream install or setup path that matches your environment:
- npx agmsg
- npx agmsg # one-shot, no global install
- npm i -g agmsg && agmsg install
- git clone https://github.com/fujibee/agmsg.git
Requirements and caveats from upstream:
- Requires: bash and sqlite3. macOS ships both. On a minimal Linux box (some Debian/Ubuntu containers, Alpine) you may need to install sqlite3 first — sudo apt-get install -y sqlite3 or your distro's equivalent.
- Monitor tool. The sandbox allowlist is still required for writes performed by
- single run. In that case, the run-specific writable roots must also include the
Basic usage or getting-started notes:
That's it. The slash command prompts you for a team name and an agent name on first use, then asks you to pick a delivery mode (default on Claude Code: monitor — real-time push; Codex offers a beta...
Prefer to inspect the code first, track the latest main, or pick a custom command name? See Install below for the setup.sh one-liner, git clone, and the Claude Code plugin marketplace paths.
agmsg is a thin transport. Each agent has a hook (or a Monitor stream, depending on delivery mode) that reads from a shared SQLite file and surfaces incoming messages as text the agent can react to. Sending is a send....
Source: https://github.com/fujibee/agmsg
Extracted from upstream docs: https://raw.githubusercontent.com/fujibee/agmsg/HEAD/README.md