# emcli

A single command-line program that mediates all email access for an AI agent. The agent never
holds your email password and never talks to the mail server directly — every read and send goes
through `emcli`, which enforces the limits you configure (read-only/read-write, sender and
recipient whitelists, subject filters). Even with faulty instructions, the agent can't read mail
it isn't permitted to see or send mail to people it isn't permitted to contact.

## Getting started

```bash
export EMCLI_KEY="$(head -c 32 /dev/urandom | base64)"   # one-time: generate & save a key
emcli init                                                # create the DB, add your first account
emcli doctor                                              # confirm it connects and authenticates
```

## Documentation

See the **[User Manual](USER-MANUAL.md)** for full setup, account configuration (including Gmail
app passwords), the agent and admin command reference, the JSON output format, and troubleshooting.