Commands — Cline Connector

Full reference for all infinium-cline CLI commands.

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

init

Set up the connector with an interactive wizard.

infinium-cline 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

After running init, make sure you’ve enabled hooks in VS Code: Settings → Extensions → Cline → Features → Enable Hooks.

Non-Interactive

For CI or scripting:

infinium-cline 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 hook scripts in .clinerules/hooks/
Full re-setup — Start fresh
Cancel

test

Send a test trace to verify your credentials and connectivity.

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

Displays:

Tracing state — active or PAUSED
Agent ID — First 12 characters
Secret — Whether configured
API URL — Target endpoint
Granularity — per-session (on TaskComplete/TaskCancel)
Config source — project or env
Pending retries — Count of failed traces (if any)
Last error — Most recent error from infinium-cline errors
Hook locations — .clinerules/hooks/ path

pause

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

infinium-cline pause

resume

Resume tracing after a pause.

infinium-cline resume

history

View locally recorded trace history.

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

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

# Clear history
infinium-cline history --clear

errors

View the persistent connector error log.

infinium-cline 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-cline 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-cline status to see if any retries are pending.

update-credentials

Change your agent ID or secret.

infinium-cline 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-cline 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-cline-connector[server]
infinium-cline 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-cline health

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

uninstall

Completely remove the connector.

infinium-cline uninstall

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

Removes Infinium hook scripts from .clinerules/hooks/ (and cleans up empty .clinerules/ directories) and deletes credentials (config file + keyring secret).