Quickstart: use the hosted Agent Inbox

early-access

Install the Agent Inbox CLI, sign in, list inboxes, and connect an email event to an agent workflow.

Usage: agent-inbox login && agent-inbox inboxes
Category: agents

Quickstart: use the hosted Agent Inbox

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.