Setup · ~2 minutes

Command-line interface

irv-cli is a thin wrapper over the same MCP endpoint Claude Desktop uses. 14 commands. Built for terminal-native power users + CI integrations.

Install

npm install -g irv-cli

Note: package isn't on npm yet (Apr 2026). For now, clone the monorepo and run npm install && npm run build && npm link inside packages/cli to install locally. npm publish lands shortly.

Generate a token + log in

Same MCP token as Claude Desktop uses. Open /app/account, generate one, then:

irv login --token <your-64-char-hex-token>

Token is stored at ~/.irv/config.json (chmod 600). Run irv ping to verify.

Pick a default project

irv projects                  # see your project keys
irv use pk_live_xxx           # set default so commands don't need <key>

Run things

irv stats --range=30d         # headline metrics
irv insights                  # active AI insights
irv log --since=24h --kinds=commit,prompt_shipped
irv install pk_live_xxx       # print SDK install snippet
irv causation                 # correlations + counterfactuals + anomalies

All commands

Command	What it does
irv login [--token <t>]	Save an API token to ~/.irv/config.json (chmod 600)
irv logout	Clear the saved token
irv whoami	Show API URL + token status + default project
irv projects	List your projects
irv use <key>	Set the default project key for subsequent commands
irv stats [<key>] [--range=24h\|7d\|30d\|90d]	Headline metrics + breakdowns
irv insights [<key>]	List active insights
irv outcomes [<key>]	Measured outcomes from shipped insights
irv plan [<key>]	Code-derived tracking plan
irv log [<key>] [--since=24h] [--kinds=commit,prompt_shipped]	Project event log
irv causation [<key>]	Correlations + counterfactuals + anomalies
irv install <key>	Print the SDK install snippet
irv tools	List MCP tools the server exposes
irv ping	Verify connectivity + auth

CI / automation use

The CLI is read-only and stable across releases. A common GitHub Actions one-liner:

yaml
- name: Daily Irv summary
  run: |
    npm install -g irv-cli
    echo ${{ secrets.IRV_TOKEN }} | irv login
    irv stats --range=24h >> $GITHUB_STEP_SUMMARY
    irv log --since=24h --kinds=outcome_evaluated >> $GITHUB_STEP_SUMMARY

Config

Stored at ~/.irv/config.json
Override the API host with the IRV_API_URL env var (e.g. for self-hosted)
Edit the file directly to change the saved token, or rerun irv login