Rezolve Ai CLI

The Rezolve Ai CLI (rezolve) 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 forCopy Anchor Link

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.

InstallCopy Anchor Link

npm install -g @rezolve-ai/cli

ConfigureCopy Anchor Link

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 connectionCopy Anchor Link

rezolve health

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

CommandsCopy Anchor Link

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

Account and feedsCopy Anchor Link

Contextual Enrichment EngineCopy Anchor Link

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

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

Add "lookup": true to an enrich-content or pipeline body to look each product up by its barcode before its content is written.

Product lookupCopy Anchor Link

Find what published sources say about a product. See Product lookup.

# One barcode, every source available to your key
rezolve lookup 4006381333931 --market GB

# Name what you have, and keep it free
rezolve lookup --mpn WH-1000XM4 --brand Sony --exclude-sources web_search

# Free lookup: never runs a web search
rezolve lookup --gtin 4006381333931 --free

# See what would run and what it would cost, without looking anything up
rezolve lookup 4006381333931 --dry-run

# Also write a description from what was found
rezolve lookup 4006381333931 --enrich product-description

A batch from a file, waited for:

cat > batch.json <<'JSON'
{
  "market": "GB",
  "items": [
    { "ref": "row-1", "identifiers": { "gtin": "4006381333931" } },
    { "ref": "row-2", "identifiers": { "mpn": "WH-1000XM4" }, "hints": { "brand": "Sony" } }
  ]
}
JSON

rezolve lookup -f batch.json --wait | jq '.items[] | {ref, match: .match.status, title: .product.title}'

JobsCopy Anchor Link

pipeline always returns a job. rules and enrich-content return one for anything but a small set, and so does a large lookup.

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

UtilitiesCopy Anchor Link

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

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

Global optionsCopy Anchor Link

Next stepsCopy Anchor Link

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