Commands — Claude Code Connector

Full reference for all infinium-claude CLI commands.

If infinium-claude is not on your PATH, use python -m infinium_connector as a drop-in replacement for all commands below.

init

Set up the connector with an interactive wizard.

infinium-claude init

Option	Description
`--agent-id`	Agent ID (skip prompt)
`--agent-secret`	Agent secret (skip prompt)
`--base-url`	API base URL (default: `https://platform.i42m.ai/api/v1`)
`--no-interactive`	Skip all prompts, use flags only

Non-Interactive

For CI or scripting:

infinium-claude init \
  --agent-id "your-agent-id" \
  --agent-secret "your-secret" \
  --no-interactive

Re-Running Init

If you already have a configuration, the wizard offers:

Update credentials — Change agent ID or secret
Reconfigure hooks — Reinstall hooks for the current project
Full re-setup — Start fresh
Cancel

test

Send a test trace to verify your credentials and connectivity.

infinium-claude test

Option	Description
`-v`, `--verbose`	Print the full trace payload before sending

Returns exit code 0 on success, 1 on failure.

status

Show current configuration, tracing state, and hook info.

infinium-claude status

Displays:

Tracing state — active or PAUSED
Agent ID — First 12 characters
Secret — Whether configured
API URL — Target endpoint
Config source — project or env
Pending retries — Count of failed traces (if any)
Hook locations — Project hooks with event count

pause

Temporarily stop sending traces. Hooks stay installed but events are silently skipped.

infinium-claude pause

Aliases: infinium-claude stop

resume

Resume tracing after a pause.

infinium-claude resume

Aliases: infinium-claude continue

history

View locally recorded trace history.

infinium-claude history

Option	Description
`-n`, `--limit`	Number of entries to show (default: 10)
`--json`	Output raw JSON lines
`--clear`	Delete all history

Examples

# Last 25 traces
infinium-claude history -n 25

# Machine-readable output
infinium-claude history --json

# Clear history
infinium-claude history --clear

retry

Resend traces that failed due to network issues.

infinium-claude retry

Option	Description
`--dry-run`	Show what would be retried without sending

Failed traces are automatically saved when a send fails on session end. Use infinium-claude status to see if any retries are pending.

update-credentials

Change your agent ID or secret.

infinium-claude update-credentials

Option	Description
`--agent-id`	New agent ID (skip prompt)
`--agent-secret`	New agent secret (skip prompt)

cleanup

Remove stale temporary session files.

infinium-claude cleanup

Option	Description
`--max-age`	Max age in seconds (default: 3600)
`--session-dir`	Override session directory

uninstall

Completely remove the connector.

infinium-claude uninstall

Option	Description
`-y`, `--yes`	Skip confirmation prompt

Removes hooks from Claude Code settings and deletes credentials (config file + keyring secret).