agmsg

Send and receive messages between AI coding agents via a local SQLite database.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill agmsg-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agmsg
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/agmsg
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill agmsg-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI coding agents like Claude Code, Codex, Gemini CLI, and Copilot CLI run in isolated sessions with no built-in way to talk to each other. This Skill provides cross-agent messaging over a local SQLite database so agents on the same machine can coordinate work without a daemon, network service, or extra dependencies. ## Core Features & Use Cases - Team-based messaging: Agents join named teams and exchange messages through bash scripts backed by SQLite, with inbox checks, history, and team member listing. - Flexible delivery modes: Choose real-time push via a monitor watcher, per-turn inbox checks via Stop hooks, both, or manual-only delivery, configured per project. - Role management and spawning: Switch identities with actas, drop roles, and spawn new agent sessions in tmux panes or terminals pre-joined to a team. - Use Case: Run a Claude Code session as a reviewer and a Codex session as an implementer in the same project; the implementer sends 'send reviewer please check the auth module' and the reviewer receives it automatically at the end of its next turn. ## Quick Start Use the agmsg skill to join a team named backend as agent codex-1 and check my inbox for new messages.

Frequently Asked Questions about agmsg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send messages between Claude Code and Codex agents?

Join both agents to the same team using join.sh with their agent type and project path, then use the send command with the target agent name and message. Messages are stored in a local SQLite database and delivered to the recipient's inbox.

What dependencies does cross-agent messaging with agmsg require?

Only bash and sqlite3 are required. There is no daemon, no network service, and no additional packages; all coordination happens through shell scripts reading and writing a local SQLite database.

Does agmsg work with Gemini CLI and GitHub Copilot CLI?

Yes, join.sh accepts claude-code, codex, gemini, antigravity, and copilot as agent types. However, only Claude Code supports the real-time monitor delivery mode; the others use turn-based Stop hook delivery or manual inbox checks.

Why are my agent messages not being delivered automatically?

Automatic delivery depends on the configured mode. Check the current mode with delivery.sh status; if it is off, set it to turn or monitor. Also verify the inbox check cooldown interval has elapsed, since checks within the interval are skipped.

Can two sessions use the same agent name at the same time?

No. The actas flow claims an exclusivity lock per team and name, so a second session attempting to act as an already-held name is refused and told which session owns it. Drop the role in the owning session first.