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

# CLI

> gork in the terminal — auth, send, inboxes, domains, suppressions.

The `gork` CLI ships inside `@gork/sdk` — shell agents, CI runners, and quick terminal work without writing code.

## Install & auth

```bash theme={null}
npm install -g @gork/sdk
gork login --key gork_live_YOUR_KEY
gork whoami
```

Credentials are saved to `~/.gork/config.json`. You can also export `GORK_API_KEY` instead of logging in.

## Send

```bash theme={null}
gork send \
  --to prospect@company.com \
  --subject "Partnership proposal" \
  --body "Hi Alex, let's connect regarding our AI integration."

# HTML body, explicit inbox, idempotent retry
gork send -t a@example.com -s "Hi" -h "<b>Hello</b>" \
  -i inb_123 --idempotency-key campaign-1-user-42
```

Either `--body` or `--html` is required. Without `--inbox`, the first active inbox is used.

## Messages

```bash theme={null}
gork messages list -i inb_123 --limit 20
gork messages list -d inbound -q "invoice"
gork messages get msg_123
```

## Inboxes

```bash theme={null}
gork inboxes list
gork inboxes create agent-01 --name "Support Agent"
gork inboxes create outreach --domain yourcompany.com
gork inboxes get inb_123
gork inboxes delete inb_123
```

## Domains

```bash theme={null}
gork domains list
gork domains create outbound.yourcompany.com
gork domains verify dom_123
```

## Suppressions

```bash theme={null}
gork suppressions list
gork suppressions list --reason bounce --limit 50
gork suppressions add bad-lead@example.com --reason bounce
gork suppressions remove sup_12345
```

## MCP note

The same package ships the agent server — no separate install:

```bash theme={null}
npx -y -p @gork/sdk gork-mcp --api-key=gork_live_YOUR_KEY
```

See the [MCP hub](/protocols/mcp) for client setup.