@intersector/cli

Governance primitives, from the terminal

Run agents, open issues, execute playbooks, search entities, and manage governance without leaving your terminal. Pipe-friendly output for CI/CD pipelines and scripts.

Get Started See Commands → 
$ intersector agents run guardian --input '{"scope":"all"}'
Agent run started: run_8f3a2b1c
Status: running

$ intersector issues list --severity critical --output table
ID          TITLE                    SEVERITY  STATUS
iss_4f21    Missing SLA on payments  critical  open
iss_7b33    Stale health check       critical  open

$ intersector entities search "payment" --type block
Found 3 results:
  payment-gateway    (service)   Team: Payments
  payment-processor  (service)   Team: Payments
  payment-webhooks   (component) Team: Platform

11 command groups. One CLI.

Every command maps to an MCP tool call. No local business logic. Your governance data stays on your server.

agents

Run AI agents and check execution status

list · run <agentId> · status <runId>

issues

Open, list, transition, and comment on governance issues

open · list · transition · comment

playbooks

Execute governance playbooks with custom input

run <playbookId>

blocks

Describe architecture blocks with full dependency context

describe <blockId>

entities

Full-text search across all 60+ entity types

search <query>

skills

Browse available agent skills

list

docs

Read and search documentation

read <docId> · search <query>

assessments

Submit governance assessments programmatically

submit <assessmentId>

auth

Authenticate and manage credentials

login · logout · whoami

Built for automation

Every design decision optimizes for scripting, piping, and CI/CD integration.

⌨

Smart output formats

Human-readable in TTY, JSON when piped. Also supports YAML and ASCII table. Use --output to override.

🔒

Multi-profile auth

Switch between staging, production, and sandbox environments with named profiles. Credentials stored securely in ~/.intersector/.

⚡

Zero local logic

Every command translates to a single MCP tool call via HTTP. No local database, no state. Your data stays on your server.

🛠

CI/CD native

Use INTERSECTOR_API_KEY and --no-input for non-interactive pipelines. Exit codes follow Unix conventions.

👁

Transparent telemetry

Optional, anonymous, command-names-only telemetry. Opt in or out at any time with intersector telemetry enable/disable.

🌐

Environment variables

INTERSECTOR_ENDPOINT, INTERSECTOR_API_KEY, INTERSECTOR_PROFILE, NO_COLOR. Full 12-factor compatibility.

Up and running in 60 seconds

Install globally via npm, authenticate with your API key, and start governing.

1

Install

Install the CLI globally from npm.

2

Authenticate

Log in with your Intersector API key or endpoint URL.

3

Govern

Run agents, search entities, open issues, execute playbooks.

Terminal 
# Install
npm install -g @intersector/cli

# Authenticate
intersector auth login --endpoint https://app.intersector.io

# Verify
intersector auth whoami

# Run your first agent
intersector agents list
intersector agents run guardian --input '{"scope":"all"}'

# Search across your governance data
intersector entities search "payment" --output table

Governance at the speed of a keystroke

Integrate governance checks into CI pipelines, automate agent runs, and script your compliance workflows.

Join the Waiting List Explore MCP Server →