Full reference for all infinium-copilot CLI commands.

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

init

Set up the connector with an interactive wizard.

infinium-copilot 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-copilot init \
  --agent-id "your-agent-id" \
  --agent-secret "your-secret" \
  --no-interactive

Re-Running Init

If you already have a configuration, the wizard offers:

1. Update credentials — Change agent ID or secret
2. Reconfigure hooks — Reinstall hooks in hooks.json
3. Change trace granularity — Per-turn, per-session, or both
4. Full re-setup — Start fresh
5. Cancel

---

test

Send a test trace to verify your credentials and connectivity.

infinium-copilot 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-copilot status

Displays:

• Tracing state — active or PAUSED
• Agent ID — First 12 characters
• Secret — Whether configured
• API URL — Target endpoint
• Granularity — per-session / per-turn / both
• Config source — project or env
• Pending retries — Count of failed traces (if any)
• Last error — Most recent error from infinium-copilot errors
• Hook locations — Path to hooks.json

---

pause

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

infinium-copilot pause

---

resume

Resume tracing after a pause.

infinium-copilot resume

---

history

View locally recorded trace history.

infinium-copilot 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-copilot history -n 25

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

# Clear history
infinium-copilot history --clear

---

errors

View the persistent connector error log.

infinium-copilot errors

Option	Description
-n, --limit	Number of entries to show (default: 20)
--json	Output raw JSON lines
--clear	Delete the error log

Errors are logged when the connector encounters network failures, malformed payloads, keyring issues, or background-worker spawn failures.

---

retry

Resend traces that failed due to network issues.

infinium-copilot retry

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

Failed traces are automatically saved to a failed/ directory on send failure. Use infinium-copilot status to see if any retries are pending.

---

update-credentials

Change your agent ID or secret.

infinium-copilot 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-copilot cleanup

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

---

start

Run the connector in HTTP server mode (alternative to command hooks). Requires the [server] extra:

pip install infinium-copilot-cli-connector[server]
infinium-copilot start

Option	Description
--host	Bind host (default: 127.0.0.1)
--port	Bind port (default: 9339)
--log-level	Log level

---

health

Check whether the HTTP server is reachable.

infinium-copilot health

Option	Description
--host	Server host (default: 127.0.0.1)
--port	Server port (default: 9339)

---

uninstall

Completely remove the connector.

infinium-copilot uninstall

Option	Description
-y, --yes	Skip confirmation prompt

Removes Infinium entries from hooks.json (deletes the file if all entries were ours) and credentials (config file + keyring secret).