Skip to content

v0.2.0macOS · Linux · Windows

BotInbox CLI

Email inboxes for your agents, from the terminal. Create inboxes, send and read mail, and wait for verification codes in CI. One small binary, no dependencies.

InstallCLI docs

  • macOS · Homebrew

    brew install botinbox-dev/tap/botinbox

  • macOS · Linux

    curl -fsSL https://botinbox.dev/install.sh | sh

  • Windows · PowerShell

    irm https://botinbox.dev/install.ps1 | iex

Install

One command on every platform.

The installers pick the right build for your CPU, verify its checksum before installing, and are safe to re-run to update.

  • Homebrew keeps it updated with brew upgrade
  • Installers verify SHA-256 before anything is written
  • No root needed: falls back to ~/.local/bin
# Homebrew (recommended): installs shell completions too
brew install botinbox-dev/tap/botinbox

# Or the install script
curl -fsSL https://botinbox.dev/install.sh | sh

Direct downloads · v0.2.0

Prefer to install by hand?

Download the archive for your platform, check it against the published SHA-256 checksum, and put botinbox on your PATH.

SHA256SUMS

Verify with shasum -a 256 <file> (macOS), sha256sum <file> (Linux), or Get-FileHash <file> (Windows).

What you can do

Your agent's inbox, in a few commands.

Create an API key in the dashboard, log in once, and go. Every command supports --json.

  • Inboxes and mail

    Create inboxes, send, reply, search, and read threads. Any inbox argument takes an ID or an address.

  • Codes in CI

    wait blocks until a matching email arrives, then prints the code. Exits 1 on timeout.

  • Live events

    tail streams message events over SSE and reconnects automatically.

  • Scoped keys

    Create account, pod, or inbox keys, and keep several profiles for different agents.

  • MCP setup

    Print ready-to-paste configs for Claude Code, Claude Desktop, and Cursor.

  • Scriptable

    --json on every command, clean stdout, and clear exit codes.

terminal

# Store your API key (hidden prompt; checked against the API)
$ botinbox login

# Create an inbox for your agent
$ botinbox inboxes create --username scout --display-name "Scout Agent"

# Send an email
$ botinbox send --from scout@mail.botinbox.dev --to you@example.com \
    --subject "Hello" --text "Sent from my terminal"

# Wait for a verification email and print only the code (CI)
$ CODE=$(botinbox wait --inbox scout@mail.botinbox.dev \
    --subject-contains verify --since 2m --timeout 90s --code)

# Stream live events, or print MCP setup for Claude Code
$ botinbox tail
$ botinbox mcp --client claude-code

Full command reference, configuration, and CI examples in the CLI docs.