The CLI is not behaving

Install issues, auth, and reading exit codes.

The CLI is published on npm as argorant. Most problems are install or auth, and the exit codes tell you which.

  • Command not found. Run it without installing: npx argorant count "fintech CFOs in Germany". Or install globally with npm install -g argorant and reopen your terminal so the path refreshes.
  • Auth failures (exit code 2). Run argorant login <key> with a current ag_live_ key. If the key was revoked, create a new one under Profile then API keys.
  • Payment required (exit code 5). The balance is empty. Top up the wallet or move to a plan, then re-run.
  • Exit code 0 means the command succeeded, and codes 1, 3 and 4 cover other failures. All of them are machine-readable so CI pipelines and agents can branch rather than guess.

Two behaviors that surprise people. First, count and search are free, so use them freely while debugging. Second, reveal and export spend credits, so ask before running them non-interactively in a script.

If an export seems lost, it is not. Use argorant export status and then argorant export download, or pick the file up from the Exports page, where every paid export stays available.

Sign out on a shared machine with argorant logout.

Still stuck? support@argorant.com