Installation - Complior

Install

npx (recommended)
curl
npm
cargo (Rust binary)
GitHub Release (binary)

No install needed — runs directly:

npx complior scan
npx complior init
npx complior eval --target http://localhost:3000/api/chat

For persistent use, install globally:

npm install -g complior

curl -fsSL https://get.complior.dev | sh

Detects your OS and architecture, downloads the latest release, and adds complior to your PATH.

npm install -g complior

cargo install complior-cli

Builds from source. Requires Rust toolchain.

Download the prebuilt binary for your platform from GitHub Releases:

Platform	Asset
Linux x86_64	`complior-linux-x86_64`
Linux ARM64	`complior-linux-aarch64`
macOS Intel	`complior-macos-x86_64`
macOS Apple Silicon	`complior-macos-arm64`
Windows	`complior-windows-x86_64.exe`

# Example: Linux x86_64
curl -fsSL -o complior https://github.com/complior/complior/releases/latest/download/complior-linux-x86_64
chmod +x complior
sudo mv complior /usr/local/bin/

# Verify checksum (optional but recommended)
curl -fsSL -o checksums.txt https://github.com/complior/complior/releases/latest/download/checksums.txt
sha256sum -c checksums.txt --ignore-missing

Requirements: Node.js 18+ for the Engine. Rust toolchain is only needed for cargo install or building TUI from source. The GitHub Release binary embeds the Rust CLI; the Engine still requires Node.js when invoked.

Verify installation

complior --version
# complior 1.0.1

complior doctor
# ✓ Engine: OK
# ✓ Node.js: v22.1.0
# ✓ TUI: OK
# ✓ MCP: OK

All green checks mean Complior is ready. If any component shows an issue, complior doctor will suggest how to fix it.

LLM configuration

Some features require an LLM API key: complior scan --llm, complior eval --llm, complior fix --ai. After complior init, add your LLM settings to .complior/.env:

# .complior/.env
LLM_PROVIDER=openai              # openai | anthropic | openrouter | ollama
LLM_MODEL=gpt-4o                 # model name
LLM_API_KEY=sk-...               # your API key

OpenAI
Anthropic
OpenRouter
Ollama (local)

LLM_PROVIDER=openai
LLM_MODEL=gpt-4o
LLM_API_KEY=sk-...

LLM_PROVIDER=anthropic
LLM_MODEL=claude-sonnet-4-20250514
LLM_API_KEY=sk-ant-...

LLM_PROVIDER=openrouter
LLM_MODEL=anthropic/claude-sonnet-4-20250514
LLM_API_KEY=sk-or-...

LLM_PROVIDER=ollama
LLM_MODEL=llama3
# No API key needed — runs locally

.complior/.env is gitignored by default. Never commit API keys to version control.

What gets installed

Component	Description	Size
Engine	TypeScript daemon — scanner, fixer, passport service, HTTP API	~15 MB
CLI	Rust binary — 30+ commands, headless mode for CI/CD	~10 MB
TUI	Terminal dashboard — 9 interactive pages (ratatui)	Included in CLI
MCP Server	Protocol server for AI agents (stdio)	Included in Engine

Configure for AI agents

To use Complior with Claude Code, Cursor, or other MCP-compatible agents:

Claude Code
Cursor
Windsurf

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "complior": {
      "command": "complior",
      "args": ["mcp"]
    }
  }
}

Add to Cursor MCP settings:

{
  "complior": {
    "command": "complior",
    "args": ["mcp"]
  }
}

Add to Windsurf MCP config:

{
  "complior": {
    "command": "complior",
    "args": ["mcp"]
  }
}

Next steps

Quick Start

Run your first scan in under 3 minutes.

​Install

​Verify installation

​LLM configuration

​What gets installed

​Configure for AI agents

​Next steps

Quick Start

Install

Verify installation

LLM configuration

What gets installed

Configure for AI agents

Next steps