@execlave/cli
v1.0.3
Published
CLI for the Execlave AI agent governance platform
Maintainers
Readme
@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/cliOr run ad-hoc without installing:
npx @execlave/cli --helpQuick start
# 1. Log in (stores token under your OS config dir)
execlave login
# 2. Point at an org
execlave workspace use <org-id>
# 3. Check where you're pointed
execlave statusCommands
| Command | What it does |
| -------------------- | ------------------------------------------------------------------ |
| execlave login | Authenticate with your Execlave account and store credentials |
| execlave status | Show the active workspace, org, and API endpoint |
| execlave workspace | List/switch workspaces |
| execlave org | Org info and membership |
| execlave agents | List, register, inspect, or archive agents |
| execlave policies | List and manage policies |
| execlave traces | Query execution traces |
| execlave incidents | Export or investigate incidents |
| execlave prompts | Inspect prompt-injection detections |
| execlave bootstrap | Scaffold execlave.config.json and SDK wiring in an existing repo |
Run execlave <command> --help for detailed flags.
Configuration
The CLI reads from (in order):
- CLI flags (
--api-url,--token) - Environment variables (
EXECLAVE_API_URL,EXECLAVE_API_KEY) - Config file at
~/.config/execlave/config.json(Linux/macOS) or%APPDATA%\execlave\config.json(Windows)
Set a non-default API endpoint:
execlave workspace set --api-url https://api.execlave.comAuthentication
Two modes:
- User session —
execlave loginopens a browser, drops a token into the config file. Used for interactive CLI sessions. - API key — set
EXECLAVE_API_KEY=exe_prod_...(orexe_test_...) for CI pipelines. Create keys athttps://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
