Skip to main content

Dwellir CLI

The Dwellir CLI (dwellir) gives you full access to the Dwellir platform from the command line. Authenticate, manage API keys, discover 150+ blockchain endpoints, monitor usage, and inspect error logs -- all without leaving your terminal.

It is built for three audiences:

  • Developers who prefer terminal workflows over a web dashboard
  • CI/CD pipelines that need to provision and rotate API keys automatically
  • AI agents that consume structured JSON output

Quick start#

# Install
curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh

# Authenticate
dwellir auth login

# List your API keys
dwellir keys list

# Discover Ethereum endpoints
dwellir endpoints search ethereum

Also available via Homebrew, AUR, go install, or from source.

Output modes#

Every command supports multiple output modes:

  • --human -- formatted tables and key-value displays (default in interactive terminals)
  • --json -- JSON wrapped in a standard {ok, data, meta} envelope for scripting and automation
  • --toon -- experimental TOON format (structured text)

When stdout is not a terminal (e.g., piped to another command or run in CI), the CLI automatically outputs JSON. Use --human to force human-readable output in non-interactive environments.

dwellir keys list --json

JSON responses use a consistent envelope:

{
  "ok": true,
  "data": { ... },
  "meta": {
    "command": "keys.list",
    "timestamp": "2026-02-26T12:00:00Z"
  }
}

Errors return ok: false with an error code, message, and optional help text, plus a non-zero exit code.

Command overview#

CommandDescription
dwellir authLogin, logout, check status, print tokens
dwellir keysCreate, list, update, enable, disable, and delete API keys
dwellir endpointsBrowse and search 150+ blockchain endpoints
dwellir usageView billing-cycle summary, usage by endpoint/method, costs, and RPS
dwellir logsInspect error logs, stats, and facet aggregations
dwellir accountView organization info and subscription details
dwellir docsList, search, and fetch Dwellir documentation as markdown
dwellir configGet and set CLI configuration values
dwellir completionGenerate or install shell completions (bash, zsh, fish, powershell)
dwellir updateSelf-update to the latest release
dwellir versionPrint build and version metadata

Global flags#

These flags work on every command:

FlagDescription
--jsonOutput as JSON (auto-selected when stdout is not a terminal)
--humanOutput as human-readable tables (default in interactive terminals)
--toonOutput as TOON format (experimental)
--profile <name>Use a specific auth profile
-q, --quietSuppress non-essential output
--anon-telemetryAnonymize telemetry data

Run dwellir --help or dwellir <command> --help for full usage details.

Next steps#