Skip to main content
ClaudeWave
Skill389 repo starsupdated today

agent-mail

Agent Mail is a Codex-native operator skill for managing file leases, system notifications, inboxes, and conflict prevention across distributed agent operations. Use it when coordinating multiple agents working with shared files, need to prevent simultaneous access conflicts, send notifications between agents, or maintain durable task state through a message-based side channel integrated with local shell operations.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/boshu2/agentops /tmp/agent-mail && cp -r /tmp/agent-mail/skills-codex/agent-mail ~/.claude/skills/agent-mail
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# agent-mail (Codex)

Codex-native entry point for the `agent-mail` operator skill.

The AgentOps source skill `../../skills/agent-mail/SKILL.md` is the source of truth
for domain behavior, commands, examples, references, and output expectations.
Read it first, then use `prompt.md` for the Codex runtime profile.

## Codex Runtime Contract

- Use Codex plus the local shell. Do not invoke Claude Code as an executor.
- Load only the relevant source references or scripts for the task.
- Prefer robot/JSON/NDJSON command surfaces when the source skill exposes them.
- Keep durable task state, evidence, and closure in BR/beads; use Agent Mail as the side channel for leases and pings.
- Verify command syntax from local `--help` or checked-in references before acting.
- Return concrete evidence: commands run, files touched, exit codes, and any remaining blocker.