CLI Reference

Scan Command

Basic syntax:

clausi scan PATH [options]

Default: Scans run on your machine using your own AI key. Clausi picks up ANTHROPIC_API_KEY or OPENAI_API_KEY automatically, or you can name a provider with --claude / --openai. Clausi is free; you pay your AI provider directly for usage.

Scan Options

FlagDescription
-r, --regulationRegulation key (repeat for multiple)
--claude [MODEL]Scan with Claude using your own Anthropic API key
--openai [MODEL]Scan with OpenAI using your own OpenAI API key
--presetUse clause preset (critical-only, high-priority) - saves 60-80% cost
--open-findingsAuto-open findings.md in your default editor
--templateReport template (default, detailed, executive)
-o, --outputOutput directory (otherwise uses config)
--max-costMaximum cost in dollars (e.g., --max-cost 1.00)
--skip-confirmationSkip the confirmation prompt
--min-severityMinimum severity to report (info, warning, high, critical)
--ignoreIgnore files/directories (can be given multiple times)
--show-cache-statsDisplay cache statistics (shows cost savings)

Examples

EU AI Act Scan

clausi scan . -r EU-AIA

Uses whichever provider key is set in your environment

Scan with Claude (BYOK)

clausi scan . -r EU-AIA --claude

Uses your Anthropic API key; billed by Anthropic, not by Clausi

Multiple Regulations

clausi scan ~/project -r EU-AIA -r GDPR -r SOC2

Cost-Saving Preset

clausi scan . -r EU-AIA --preset critical-only --open-findings

Scans only critical clauses (saves 60-80% cost)

Output Files

Upon completion the CLI stores reports in your project's clausi/ folder:

  • findings.md – Main compliance findings report
  • traceability_matrix.md – Code-to-clause mapping
  • compliance_report.pdf – Executive PDF report
  • metadata.json – Scan session metadata

Configuration

Settings are stored in a YAML file:

Windows: %USERPROFILE%\.clausi\config.yml
macOS/Linux: ~/.clausi/config.yml

Example configuration:

# API keys (optional - for BYOK mode)
api_keys:
  anthropic: "sk-ant-..."  # For --claude flag
  openai: "sk-..."         # For --openai flag

report:
  company_name: "ACME Corp"
  company_logo: "C:/assets/logo.png"
  template: "default"      # default | detailed | executive

regulations:
  default: EU-AIA          # default regulation for scans

Config Commands

CommandPurpose
clausi config showDisplay current configuration
clausi config set [...]Update configuration values
clausi config editOpen config in your editor
clausi config pathPrint config file location

Environment Variables

VariablePurpose
ANTHROPIC_API_KEYAPI key for Claude (Anthropic) - for BYOK mode
OPENAI_API_KEYAPI key for OpenAI - for BYOK mode
CLAUSI_OUTPUT_DIROverrides output directory

Precedence: CLI flag → environment variable → config file → default

Tip: Setting your API key

Set your API key as an environment variable and Clausi picks it up automatically:

export ANTHROPIC_API_KEY=sk-ant-your-key-here

Get your key from: console.anthropic.com