agent-team-mail (atm)

agent-team-mail is the retained 1.0 CLI and core library for local ATM mailbox workflows.

This repository is now the source of truth for publishing:

• agent-team-mail
• agent-team-mail-core

The installed command remains atm.

What 1.0 Includes

The retained 1.0 release scope is the daemon-free CLI/core pair:

• agent-team-mail — the atm CLI
• agent-team-mail-core — the core Rust library used by the CLI

This release line continues to consume the published sc-observability family for retained logging and health reporting:

• sc-observability
• sc-observability-types
• sc-observability-otlp

This repo does not publish the retired legacy daemon, MCP, TUI, or CI-monitor artifacts as part of the retained 1.0 surface.

Installation

GitHub Releases

Download the latest release from GitHub Releases.

Published archives:

Extract the archive and place atm or atm.exe somewhere on your PATH.

Homebrew

brew tap randlee/tap
brew install randlee/tap/agent-team-mail

crates.io

cargo install agent-team-mail

The library crate is also published as:

cargo add agent-team-mail-core

winget

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.

Build From Source

git clone https://github.com/randlee/atm-core.git
cd atm-core
cargo install --path crates/atm --bin atm

Quick Start

ATM works against the local Claude team mailbox layout under ~/.claude/teams. Typical flows:

Send a message

atm send teammate "Hello from ATM"
atm send teammate@other-team "Cross-team message"
atm send teammate "Please confirm" --requires-ack

Read your mailbox

atm read
atm read --all --no-mark
atm read --pending-ack-only

Acknowledge or clear messages

atm ack <message-id> "Acknowledged"
atm clear

Inspect health and retained logs

atm doctor
atm log snapshot --level warn

Manage teams

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 <command> --help for the full command surface.

CLI Surface

The retained CLI includes:

• send
• read
• ack
• clear
• log
• doctor
• teams
• members

The teams command also contains retained team-administration subcommands:

• add-member
• backup
• restore

Configuration Notes

ATM resolves runtime identity and team context from the current CLI/config surface and uses the local Claude team directory layout for mailbox storage.

Useful docs in this repo:

• requirements.md
• architecture.md
• project-plan.md
• WINGET_SETUP.md

Development

cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace