# Gc Mail

> Sending and reading messages between agents

- Skill: `gastownhall/gc-mail` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gastownhall/gc-mail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gastownhall/gc-mail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gastownhall (https://skillmd.com/u/gastownhall)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gastownhall/gc-mail

---


# Messaging (Mail)

Mail is bead-based messaging between agents. Messages are beads with
type=message, stored in the bead store.

## Sending

```
gc mail send <to> -m "message body"                    # Send a message
gc mail send <to> -s "Subject" -m "message body"       # Send with subject
gc mail reply <id> -m "reply body"                     # Reply to a message
gc mail reply <id> -s "Re: topic" -m "reply body"      # Reply with subject
```

## Reading

```
gc mail inbox                          # List unread messages
gc mail count                          # Count unread messages
gc mail peek <id>                      # Preview a message without marking read
gc mail read <id>                      # Read a message (marks as read)
gc mail thread <id>                    # Show full conversation thread
```

## Managing

```
gc mail archive <id>                   # IRRECOVERABLE: deletes the underlying bead, despite the name
gc mail mark-read <id>                 # Mark as read without displaying
gc mail mark-unread <id>              # Mark as unread
gc mail delete <id>                    # IRRECOVERABLE: alias for archive; deletes the underlying bead
gc mail check                          # Check for new mail (used in hooks)
```

`archive` and `delete` are the same operation under two names — both delete
the message's underlying bead outright; neither files it away for later
reading. There is no reversible "put this away" path. Prefer `mark-read` when
you want a message out of the unread count without destroying it.