winget install --id=randlee.agent-team-mail -e agent-team-mail (atm) is a daemon-free CLI for mail-like messaging with Claude agent teams. It provides send, read, ack, clear, doctor, log, teams, and members workflows over a file-based API with atomic I/O and conflict detection.
atm)agent-team-mail is the retained ATM CLI and daemon-backed runtime for local
ATM mailbox workflows.
This repository is now the source of truth for publishing:
agent-team-mailagent-team-mail-coreThe current Phase AI branch candidate is 1.4.0-beta-ai; its CLI and
daemon must be switched and run as a matching pair for branch smoke evidence.
Run that evidence only through the canonical just smoke command surface.
The installed command remains atm.
The retained release scope is the atm CLI plus the accepted same-host
daemon/SQLite runtime it bootstraps and talks to:
agent-team-mail — the atm CLI entrypointagent-team-mail-core — shared semantic and boundary codeatm-daemon — the retained same-host daemon runtime used by send, read,
ack, and doctorThis release line continues to consume the published sc-observability family
for retained logging and health reporting:
sc-observabilitysc-observability-typessc-observability-otlpThis repo does not publish the retired Claude-compatibility runtime, MCP, TUI, or CI-monitor artifacts as part of the retained ATM surface.
Download the latest release from GitHub Releases.
Published archives:
| Platform | Archive |
|---|---|
| Linux (x86_64) | atm__x86_64-unknown-linux-gnu.tar.gz |
| macOS (Intel) | atm__x86_64-apple-darwin.tar.gz |
| macOS (Apple Silicon) | atm__aarch64-apple-darwin.tar.gz |
| Windows (x86_64) | atm__x86_64-pc-windows-msvc.zip |
Extract the archive and place atm or atm.exe somewhere on your PATH.
brew tap randlee/tap
brew install randlee/tap/agent-team-mail
cargo install agent-team-mail
The library crate is also published as:
cargo add agent-team-mail-core
hermes-atm and atm-graft 1.4.2 are live on TestPyPI; publishing to
production PyPI is pending.
python -m pip install --upgrade \
--index-url https://test.pypi.org/simple \
--extra-index-url https://pypi.org/simple \
"hermes-atm==1.4.2" "atm-graft==1.4.2"
For Hermes setup and verification, see the hermes-atm guide.
winget install randlee.agent-team-mail
winget is a new required 1.0 Windows channel rather than a historical
parity channel from the old repo. Public winget installability may lag by
1-2 days after release because Microsoft reviews new submissions and updates
before they become broadly visible.
git clone https://github.com/randlee/atm-core.git
cd atm-core
cargo install --path crates/atm --bin atm
ATM runs against the accepted ATM home/runtime layout and persists retained mail state through the same-host daemon plus durable SQLite storage. Typical flows:
atm send teammate "Hello from ATM"
atm send teammate@other-team "Cross-team message"
atm send teammate "Please confirm" --requires-ack
atm read
atm peek --all
atm read --pending-ack-only
atm ack "Acknowledged"
atm clear
atm doctor
atm log snapshot --level warn
atm teams
atm members my-team
atm teams add-member my-team teammate
atm teams backup my-team
atm teams restore my-team --from backup.tar.gz --dry-run
Run atm --help or atm --help for the full command surface.
The retained CLI includes:
sendreadackclearlogdoctorteamsmembersThe teams command also contains retained team-administration subcommands:
add-memberbackuprestoreATM resolves runtime identity and team context from the current CLI/config surface and uses the accepted daemon/SQLite runtime for retained mail state.
ATM ships one default post-send path for successful atm send and atm ack:
the built-in atm internal-nudge command. Most teams do not need any
.atm.toml hook configuration.
Use [[atm.post_send_hooks]] only for an explicit local override or
compatibility helper:
[[atm.post_send_hooks]]
recipient = "team-lead"
command = ["scripts/atm-nudge.sh", "team-lead"]
[[atm.post_send_hooks]]
recipient = "arch-ctm"
command = ["scripts/atm-nudge.sh", "arch-ctm"]
Behavior:
atm internal-nudge path.[[atm.post_send_hooks]] rule binds one recipient and one command.recipient matches either one exact member name or * for all recipients.command[0] is path-like, ATM resolves it relative to the directory containing .atm.toml.bash, python3, or tmux use normal PATH resolution.post_send_hook, post_send_hook_senders, post_send_hook_recipients, and post_send_hook_members keys with migration guidance.ATM_POST_SEND to a JSON payload with {from, to, sender, recipient, team, message_id, requires_ack} plus optional task_id when present.level, message, and optional fields for ATM to log.--stderr-logs with ATM_LOG=debug to surface debug-level hook results on stderr.atm send still succeeds and prints a warning.Repo-local scripts/atm-nudge.sh / scripts/atm-nudge.py remain
compatibility-only helpers. They are not the shipped default.
Example ATM_POST_SEND payload:
{
"from": "team-lead@atm-dev",
"to": "arch-ctm@atm-dev",
"sender": "team-lead",
"recipient": "arch-ctm",
"team": "atm-dev",
"message_id": "01KWTMCQ418Q96BFRDTKGZMEAS",
"requires_ack": true
}
Example tmux auto-nudge hook for a Codex pane:
#!/usr/bin/env bash
set -euo pipefail
readarray -t fields < <(python3 - <<'PY'
import json, os
payload = json.loads(os.environ["ATM_POST_SEND"])
print(payload["to"].split("@", 1)[0])
print(payload["to"].split("@", 1)[1])
PY
)
recipient="${fields[0]}"
team="${fields[1]}"
tmux send-keys -t "$recipient" "You have unread ATM messages. Run: atm read --team $team" Enter
Optional structured hook result on stdout:
{"level":"debug","message":"arch-ctm nudged on pane %42","fields":{"pane_id":"%42"}}
Useful docs in this repo:
Windows first-run prerequisites on a new machine:
1.94.1 with the MSVC toolchainjust (winget install Casey.Just)python resolves on PATH for repo scripts and helperscargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
Windows CI parity command:
$env:ATM_TEST_RECV_TIMEOUT_SECS="60"
cargo test --workspace --verbose