| name | agmsg |
| description | Cross-agent messaging via SQLite. Send messages between Claude Code, Codex, Gemini CLI, and other agents. No daemon, no network, no dependencies beyond bash and sqlite3. |
Agent messaging command. IMPORTANT: Always use the provided scripts. NEVER directly read or edit config files, DB, or team data. There is NO register.sh — use join.sh to join a team.
Identity
If you already know your AGENT and TEAMS from a previous $agmsg call in this session, skip to Execute below.
Otherwise, run: ~/.agents/skills/agmsg/scripts/whoami.sh "$(pwd)" codex
Four possible outputs:
A) Single identity:
agent=<name> teams=<t1,t2,...> type=codex project=<path>
→ Remember AGENT and TEAMS, then go to Execute.
B) Multiple identities:
multiple=true agents=<n1,n2,...> teams=<t1,t2,...> type=codex project=<path>
→ Ask the user which agent name to use for this session, then go to Execute.
C) Not in a team:
not_joined=true available_teams=<t1,t2,...> (or available_teams=none)
→ Show the user the available teams from the output, then:
First-time setup required.
Joining a team so this agent can send and receive messages.
- Team name: a group of agents that can message each other (available: )
- Agent name: this agent's identity within the team
- Ask: "Enter a team name (joins existing or creates new)"
- Ask: "Enter a name for this agent"
- You MUST use join.sh — run:
~/.agents/skills/agmsg/scripts/join.sh <team> <agent_name> codex "$(pwd)"
