@councilex/cli

Multi-model AI orchestration from your terminal — part of Councilex.

Install

npm install -g @councilex/cli
# or
pnpm add -g @councilex/cli

Requires Node.js >= 20.

Authenticate

councilex auth login --api-key cxl_live_xxxxxxxx --project-id <uuid>

This writes ~/.councilex/config.json with your API key, optional server URL, and default project id. Subsequent commands use those values unless overridden by flags or these env vars:

| Env var | Purpose | |---|---| | COUNCILEX_API_KEY | Override stored API key | | COUNCILEX_SERVER_URL | Override base URL (default https://api.councilex.ai) | | COUNCILEX_PROJECT_ID | Override stored default project |

Commands

councilex audit <file>

Audit a source file. Defaults to task_type=code-audit with the adversarial pattern.

councilex audit ./src/auth.ts
councilex audit ./src/auth.ts --task security-audit
councilex audit ./src/auth.ts --pack supabase-security
councilex audit ./src/auth.ts --whisper          # private to calling team member

councilex audit-plan <file>

Audit a planning or architecture doc (task_type=plan-audit).

councilex ask <question...>

Natural-language query against the project.

councilex ask "what are the 3 most critical open issues?"
councilex ask --codebase "which files have never been audited?"

councilex fix --finding <id>

Generate a unified-diff fix for a finding.

councilex fix --finding 7a3...
councilex fix --finding 7a3... --create-branch

councilex health [--history 30d] [--file path]

Project health score. --history shows a trend; --file returns a file-level score.

councilex ship-checklist

Before-you-ship readiness check. Exit code 0 = ready, 1 = blockers present.

councilex usage [--project id] [--all]

Account-level spend + session + finding totals.

councilex estimate <file> [--task type]

Estimate cost + latency before running an audit.

councilex replay --session <id> [--model id]

Replay a session, optionally swapping a single model to compare outputs.

Deferred (land in later phases)

• councilex schedule list / run <name> — Scheduler service (P5S6b).
• councilex roi — ROI dashboard (Phase 7).

Cursor / Claude Code integration

Add Councilex to your .mcp.json so your editor's AI can call it as a first-class MCP tool:

{
  "mcpServers": {
    "councilex": {
      "type": "http",
      "url":  "https://api.councilex.ai/mcp",
      "headers": {
        "X-API-Key": "cxl_live_xxxxxxxx"
      }
    }
  }
}

Exit codes

| Code | Meaning | |---|---| | 0 | Success | | 1 | Local problem (missing config, unreadable file, not-found resource) | | 2 | Server / upstream error |

Publish (maintainers)

This package publishes automatically when a cli-vX.Y.Z tag is pushed to the monorepo. The workflow lives at .github/workflows/cli-publish.yml.

License

ISC