Rezolve Ai CLI

Drive the Rezolve Ai v1 API from your terminal, including the Contextual Enrichment Engine and durable jobs.

ace-cli is the command-line interface for Rezolve Ai. Use it to run the Contextual Enrichment Engine, track durable jobs, score a feed, and check your account usage without writing any code.

Who this is for

Anyone who wants to try Rezolve Ai quickly, script it into a build step, or debug a payload before wiring it into an app. It is a thin wrapper over the Rezolve Ai SDK, so every command maps to one documented endpoint.

Install

npm install -g @rezolve-ai/cli

Renamed from @authoritas-ace/ace-cli. The old package still resolves but is no longer updated. The binary is now rezolve rather than ace.

Configure

Set your base URL and key once, and every command picks them up:

export ACE_BASE_URL=https://ace.authoritas.com
export ACE_API_KEY=ace_live_your_key_here

Both can also be passed per command with --base-url and --api-key. If ACE_BASE_URL is unset the CLI defaults to http://localhost:3001, which is only useful when running Rezolve Ai locally, so set it explicitly against production.

Create a key under Settings, Developer console, Keys. See API Keys.

Check the connection

rezolve health

This calls GET /api/v1/health and needs no key. If it fails, your base URL is wrong.

Commands

Every command prints JSON to stdout, so it pipes cleanly into jq.

Account and feeds

Command	What it does
`rezolve health`	Liveness check. No key required.
`rezolve usage`	Credit balance, rate limit, job counts, and test quota.
`rezolve feeds`	List your feeds. `--project-id <id>` to filter.

Contextual Enrichment Engine

These three read a JSON body from stdin, or from a file with -f.

Command	Endpoint
`rezolve rules`	`POST /api/v1/enrichment/rules`
`rezolve enrich-content`	`POST /api/v1/enrichment/content`
`rezolve pipeline`	`POST /api/v1/enrichment/pipeline`

cat > products.json <<'JSON'
{
  "source": {
    "type": "inline",
    "products": [
      { "id": "sku-1", "title": "Merino base layer", "category": "Outdoor" }
    ]
  },
  "contentTypes": ["product-description", "meta-tags"]
}
JSON

rezolve pipeline -f products.json

Or straight from a pipe:

echo '{"source":{"type":"inline","products":[{"id":"1","title":"Trail shoe"}]}}' | rezolve rules

Jobs

enrich-content and pipeline return a job id for anything but the smallest sets.

Command	What it does
`rezolve jobs list`	List jobs. Filter with `--kind`, `--status`, `--store-id`, `--page`, `--page-size`.
`rezolve jobs get <id>`	Fetch a job with its status and result.
`rezolve jobs results <id>`	Paginated per-product results. `--page`, `--page-size`.
`rezolve jobs cancel <id>`	Cancel a queued or running job.
`rezolve jobs wait <id>`	Poll until the job finishes. `--poll-ms`, `--timeout-ms`.

A full run, start to finish:

JOB=$(rezolve pipeline -f products.json | jq -r '.id')
rezolve jobs wait "$JOB"
rezolve jobs results "$JOB" --page-size 100 > enriched.json

Utilities

Unbilled helpers. Each reads a JSON body from stdin or -f.

Command	Endpoint
`rezolve utils language`	`POST /api/v1/utils/language`
`rezolve utils agentic-readiness`	`POST /api/v1/utils/agentic-readiness`
`rezolve utils review-quality`	`POST /api/v1/utils/review-quality`

echo '{"products":[{"id":"1","title":"Wanderschuhe für Herren"}]}' | rezolve utils language

Global options

Option	Description
`-b, --base-url <url>`	Rezolve Ai base URL. Defaults to `ACE_BASE_URL`, then `http://localhost:3001`.
`-k, --api-key <key>`	API key. Defaults to `ACE_API_KEY`.
`--version`	Print the CLI version.
`--help`	Print help for any command or subcommand.

Next steps

API Reference for request and response schemas
Rezolve Ai SDK to do the same thing from code
Troubleshooting if a command returns an error

On this page