CLI Reference

The Intutic CLI provides workspace management, harness detection, config sync, and trace querying.

Installation

npm install -g @intutic/cli

Global options

All commands support:

Option	Description
--version	Show CLI version
--help	Show help for command

---

intutic init

Initialize workspace — detect harnesses, configure sync.

intutic init [options]

Options:

Option	Description
--dev	Use local control plane (http://localhost:3001)

What it does:

1. Scans the workspace for all 8 harness config files
2. Creates a workspace on the control plane
3. Generates a virtual API key (vk_*)
4. Writes governance config into each detected harness file

---

intutic login

Authenticate with the Intutic control plane.

intutic login [options]

Options:

Option	Description
--api-key <key>	Authenticate with an API key (vk_*)
--dev	Use local control plane (http://localhost:3001)

Examples:

# Browser-based login
intutic login

# API key login
intutic login --api-key vk_abc123def456

# Local dev
intutic login --dev

---

intutic logout

Clear stored credentials.

intutic logout

No options. Removes locally stored authentication tokens.

---

intutic status

Show workspace status — auth, harnesses, sync state.

intutic status

No options. Displays:

• Current authentication state
• Detected harnesses and their config paths
• Sync state (last sync timestamp, any errors)

---

intutic whoami

Show current authenticated identity.

intutic whoami [options]

Options:

Option	Description
--dev	Use local control plane (http://localhost:3001)

---

intutic connect

Start sync daemon — bidirectional config sync with control plane.

intutic connect [options]

Options:

Option	Description	Default
--dev	Use local control plane (http://localhost:3001)	—
--interval <ms>	Poll interval in milliseconds	30000

Examples:

# Default (30s poll)
intutic connect

# 10 second poll interval
intutic connect --interval 10000

# Local dev with fast polling
intutic connect --dev --interval 5000

The daemon runs in the foreground. Use Ctrl+C to stop.

---

intutic traces list

List execution traces for the workspace.

intutic traces list [options]

Options:

Option	Description	Default
--limit <n>	Number of traces to show (1–100)	20
--since <duration>	Time window: 30m, 24h, 7d	24h
--action <type>	Filter by enforcement action	(all)
--model <name>	Filter by model name	(all)
--json	Output as JSON instead of table	false
--dev	Use local control plane (http://localhost:3001)	—

Enforcement action filter values: BYPASS, ENHANCE, HIJACK, KILL

Examples:

# Last 20 traces from past 24 hours
intutic traces list

# All KILL actions from the past week
intutic traces list --action KILL --since 7d

# JSON output for scripting
intutic traces list --json --limit 100

# Filter by model
intutic traces list --model claude-4-sonnet

---

intutic traces inspect <trace_id>

Show full detail of a single trace.

intutic traces inspect <trace_id> [options]

Arguments:

Argument	Description
trace_id	The trace ID to inspect (e.g., tr_abc123)

Options:

Option	Description
--dev	Use local control plane (http://localhost:3001)

Example:

intutic traces inspect tr_abc123

Returns full trace detail including token counts, costs, compliance scores, anomaly data, and corrective prompt card.