@execlave/cli

Command-line interface for Execlave — the AI Agent Governance Platform.

Register agents, apply policies, ship incident reports, and drive your workspace from the terminal.

Install

npm install -g @execlave/cli

Or run ad-hoc without installing:

npx @execlave/cli --help

Quick start

# 1. Log in — prompts for your backend URL + API key, verifies the
#    connection, then stores both under your OS config dir.
execlave login

# 2. Check where you're pointed (endpoint + org + connectivity)
execlave status

Commands

| Command | What it does | | --------------------- | ----------------------------------------------------------------------------------------------- | | execlave login | Authenticate (prompts for backend URL + API key) and store credentials | | execlave status | Show the active org, API endpoint, and connection status | | execlave bootstrap | Interactive setup wizard for a new Execlave environment | | execlave org | Org info (list) and settings (settings) | | execlave workspace | Workspaces — list, create | | execlave agents | Agents — list, pause <id>, resume <id> (kill switch) | | execlave policies | Policies — list, violations, apply, test, chain | | execlave traces | Execution traces — list, stats | | execlave incidents | Incidents — list, export | | execlave prompts | Prompt versions — list, deploy, rollback, approve | | execlave validators | Custom HTTP validators (BYOV) — list/show/create/update/delete/test/rotate-secret |

Governance (AMP) commands

The six AI Agent Management Platform features are scriptable for CI / GitOps / terminal triage:

| Command | What it does | | ---------------------- | ---------------------------------------------------------------------------------------------------- | | execlave registry | Agent registry & lifecycle — inventory, versions <id>, rollback <id>, lifecycle <id> <state> | | execlave cost-rules | Real-time cost budget rules — list, create, update <id>, delete <id> | | execlave drift | Permission-drift events — list, resolve <id> | | execlave suggestions | Eval-to-policy suggestions — list, accept <id>, reject <id> | | execlave autonomy | Tiered agent autonomy — show <id>, set <id> <level> | | execlave lineage | Data-access lineage — breakdown, pii-by-agent |

Run execlave <command> --help (or execlave <command> <subcommand> --help) for detailed flags.

Configuration

Credentials and endpoint resolve from (in order of precedence):

1. Environment variables — EXECLAVE_API_KEY (API key) and EXECLAVE_BASE_URL (backend host)
2. The config file written by execlave login, at %APPDATA%\execlave-cli\config.json (Windows) or ~/.config/execlave-cli/config.json (Linux/macOS)

The config file is hardened to owner-only access on write (POSIX 0600 / Windows ACL).

API version

All commands target /api/v1 by default. Override per-invocation with the global flag:

execlave --api-version v0 agents list   # legacy unversioned /api (sunsets 2026-10-01)

Authentication

The CLI authenticates with an API key (exe_prod_... / exe_stg_... / exe_dev_...):

• Interactive — execlave login prompts for the backend URL and API key, probes /health to verify them, then persists both. Credentials are never saved if the probe fails.
• Environment — set EXECLAVE_API_KEY (and optionally EXECLAVE_BASE_URL) for CI pipelines; these take precedence over the stored config. Create keys at https://www.execlave.com/dashboard/settings/api-keys.

Requirements

• Node.js 20+
• An Execlave account (sign up)

Links

• Docs: www.execlave.com/docs
• SDK-JS: @execlave/sdk
• SDK-Python: execlave-sdk
• Issues: github.com/rishitmavani/execlave/issues

License

MIT