Commands

Scanning Projects

Basic syntax:

clausi scan PATH [options]

Default: Without --claude or --openai flags, scans use Clausi AI (no API key needed). Pricing: $3.00 base + $0.40/100k LOC (up to 200k LOC).

Common Options

FlagDescription
-r, --regulationRegulation key (repeat for multiple)
--mode ai | fullai = lightweight analysis (default), full = deep scan
--format pdf | html | json | allReport format (use 'all' for PDF, HTML, and JSON)
--templateReport template (default, detailed, executive)
-o, --outputOutput directory (otherwise uses config)
--presetNEW v1.0.0: Use clause preset (critical-only, high-priority) - saves 60-80% cost
--claude [MODEL]BYOK: Use your Anthropic API key ($0.50/scan). Optional model: claude-3-5-sonnet-20241022
--openai [MODEL]BYOK: Use your OpenAI API key ($0.50/scan). Optional model: gpt-4o
--open-findingsNEW v1.0.0: Auto-open findings.md in your default editor
--show-markdownNEW v1.0.0: Show markdown preview in terminal
--show-cache-statsNEW v1.0.0: Display cache statistics (shows cost savings)
--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-detailsShow per-file token estimates

Examples

EU AI Act Scan (Clausi AI - Default)

clausi scan . -r EU-AIA

Uses Clausi AI, no API key needed

Scan with Claude (BYOK)

clausi scan . -r EU-AIA --claude

Uses your Anthropic API key, $0.50 flat rate per scan

Scan with OpenAI (BYOK)

clausi scan . -r EU-AIA --openai gpt-4o

Uses your OpenAI API key with specified model

Multiple Regulations with Detailed Template

clausi scan ~/project -r EU-AIA -r GDPR --template detailed

Cost-Saving Preset Scan

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

Scans only critical clauses (saves 60-80% cost) and opens findings in editor

Output Files (v1.0.0)

Upon completion the CLI prints a table of findings and stores:

  • findings.md (NEW) – Main compliance findings report (auto-opens in your editor)
  • traceability.md (NEW) – Code-to-clause mapping showing which files satisfy which clauses
  • action_plan.md (NEW) – Step-by-step remediation plan with priorities
  • compliance_report.pdf – Executive PDF report
  • audit_metadata.json – Summary of the scan session

Tip: Use --open-findings to automatically open findings.md in your editor after the scan completes.