Dairo CLI

The official command-line interface for Dairo — the agent-native messaging & storage API. Built for humans, AI agents, and CI/CD pipelines.

Installation

brew install dairo-app/tap/dairo
npm install -g @dairo-app/cli
curl -fsSL https://dairo.app/install.sh | sh

Native binaries ship for macOS, Linux (glibc and static musl), and Windows; the installers and the npm launcher pick the right build automatically. Update in place with dairo update.

Setup

Get an API key at dairo.app, then sign in:

dairo login                       # browser OAuth (recommended)
dairo login --device-code         # SSH / containers: enter a code from any device
export DAIRO_API_KEY="dairo_..."  # ...or set a key directly for CI

dairo login switches to the device-code flow on its own when it cannot open a browser (SSH session, display-less Linux): it prints a one-time code to enter at platform.dairo.app/activate, then waits for you to approve the sign-in.

Example

Send a message:

dairo send \
  --from you@yourdomain.com \
  --to jane@example.com \
  --subject "Hello from Dairo" \
  --text "Sent with the Dairo CLI."

Share a stored file with a signed link:

dairo share create --bucket <bucket> --object <object-id>

Commands

Run dairo --help for the full grouped command list, or dairo <command> --help for any command's options. Highlights:

• send, messages, threads, inbox — send and read mail on the unified inbox
• domain, api-key, webhook — manage sending domains, keys, and webhooks
• bucket, share, attachment — object storage and signed share links
• audience — broadcast to a saved audience
• letter — send and track physical mail
• listen — tail live inbox events (ideal for local webhook development)
• mcp — install the Dairo MCP server into your coding agent
• login, whoami, init, doctor, update — auth, scaffolding, and maintenance

Documentation

Full documentation lives at dairo.app, with the complete API and CLI reference at docs.dairo.app.

License

MIT