Quickstart: use the hosted Agent Inbox

For a coding agent

If you want a coding agent to receive e-mail, you do not need to sign in or create an inbox. Install the CLI (step 1 below), then:

agent-inbox new --label "verify signup" --allow "*@github.com"
agent-inbox wait --timeout 5m

Start with the five-minute tutorial, then Give your coding agent an e-mail address for every option. The rest of this page is for managing inboxes you own.

1. Install the CLI

Linux or macOS:

curl -fsSL https://agentics.dk/install/agent-inbox.sh | bash

Windows PowerShell:

irm https://agentics.dk/install/agent-inbox.ps1 | iex

Confirm the installed version:

agent-inbox --version

2. Sign in

agent-inbox login

The command opens the Agentics login in your browser and stores the resulting credential in ~/.agent-inbox with user-only permissions.

3. List your inboxes

agent-inbox inboxes

The output includes each inbox ID, owner, domain, and current email count.

4. Connect an agent workflow

Create a signed webhook for an inbox:

agent-inbox webhooks add \
  --inbox <owner/domain> \
  --url https://your-agent.example/email \
  --match '*'

Store the returned secret immediately; it is shown once. Receivers verify X-Inbox-Signature as an HMAC-SHA256 signature over the request body.

Test the route:

agent-inbox webhooks list --inbox <owner/domain>
agent-inbox webhooks test --inbox <owner/domain> <webhook-id>

See the CLI reference for all commands, or self-host Agent Inbox when mail and storage must remain on your infrastructure.