> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd mail

> Delegate to mail provider (e.g., gt mail)

Generated from `bd help --doc mail`.

Delegates mail operations to an external mail provider.

Agents often type 'bd mail' when working with beads, but mail functionality
is typically provided by the orchestrator. This command bridges that gap
by delegating to the configured mail provider.

Configuration (checked in order):

1. BEADS\_MAIL\_DELEGATE or BD\_MAIL\_DELEGATE environment variable
2. 'mail.delegate' config setting (bd config set mail.delegate "gt mail")

Examples:

# Configure delegation (one-time setup)

`export BEADS_MAIL_DELEGATE="gt mail"`

# or

bd config set mail.delegate "gt mail"

# Then use bd mail as if it were gt mail

bd mail inbox                    # Lists inbox
bd mail send mayor/ -s "Hi"      # Sends mail
bd mail read msg-123             # Reads a message

```
bd mail [subcommand] [args...] [flags]
```