Skip to main content
The CLI binary is caesar-search. Install it, then authenticate with an API key from the Caesar app. For a limited time, all accounts receive a $1,000 starting credit grant.

​
Install

Prebuilt archives for all platforms (including Windows), with checksums and SBOMs, are on GitHub Releases.

​
Verify

version prints caesar-search 0.2.0 (<commit>, <date>); with --json it returns {"version": ..., "commit": ..., "build_date": ...}. Search requires CAESAR_API_KEY or a key stored with caesar-search auth login (browser login).

​
Authenticate

The default is browser login — no key ever touches your clipboard:
Browser login creates a key labelled CLI · <hostname> · <date> that you can see and revoke in the console at any time. It lands in the OS keychain (macOS Keychain, libsecret on Linux) with a 0600 config-file fallback; --insecure-storage forces the file. For CI and scripts, set the CAESAR_API_KEY environment variable, or pipe a key in directly:
Never paste an API key into a chat or leave it in shell history. Prefer browser login; for raw keys, pipe them in with --key -. The CLI stores file-based keys with mode 0600, masks them in all output, and never logs them.
Check what the CLI is using:
The payload reports key_present, key_source (flag, env, keychain, config, or none), key_masked, base_url, api_reachable, and config_path. caesar-search auth logout removes the stored key. Full resolution order is on Scripting and CI.

​
Update

update detects how the CLI was installed and uses the matching channel: --check works on every channel, including dev, and returns:
Don’t run npm update -g or brew upgrade by hand — caesar-search update picks the right channel itself. If a flag errors as unknown, the installed CLI is outdated: run caesar-search update and retry.

​
Shell completions

caesar-search completion bash|zsh|fish prints a completion script to stdout. Wire it up from your shell rc file:

​
For agents

  • The binary is caesar-search, not caesar.
  • API calls require a key — verify CAESAR_API_KEY or run caesar-search auth login before search/read tasks.
  • npm install -g caesar-search-cli --ignore-scripts is safe; there are no postinstall scripts.
  • On an unknown-flag error, run caesar-search update, then retry the command.
  • Never echo or log a key; auth login --key - reads it from stdin.
Full command reference and the common-mistakes table: CLI usage.