Skip to main content
agentic-id runs every Agentic ID product from a terminal. It works on single lookups and on CSV files.

Install

The command ships with the Claude Code plugin. It needs Node.js 18 or later and installs no packages.
Install the plugin. Claude Code puts agentic-id on the PATH of the shells it starts.
The CLI is not on npm yet.

Set up

agentic-id login stores the session in ~/.agentic-id/session.json. agentic-id logout ends it on your machine and on the server. See Authentication.

Commands

Flags for every command

validate

resolve

enrich

find

discover

lookalike

report

estimate

Worked out on your machine. Nothing is sent.

CSV files

validate, resolve, enrich and report take --file. The output keeps every column and row of your file and adds columns. Repeated rows are paid once. Personal emails are not sent.
Rules for file runs:
  • Every paid file run needs --max-credits. Run with --dry-run first to see the row count and the estimate.
  • When a resolve --file run reaches the cap, it stops. The file holds what was done, rows not reached are marked not_run, and the exit code is 3.
  • --json with --file needs --out. The rows go to the file and the summary is printed as JSON.
  • Comma, semicolon and tab separated files are read. Cells that a spreadsheet would run as a formula are written with a leading quote.

Output

Errors go to stderr. With --json an error is printed as JSON with error, status, message, fix and request_id. See Errors.

Exit codes