Installation

pip install licit-ai-cli

Or from source:

git clone https://github.com/Diego303/licit-cli.git
cd licit-cli
pip install -e ".[dev]"

Invocation

# As an installed command
licit [options] <command> [arguments]

# As a Python module
python -m licit [options] <command> [arguments]

Global Options

licit --version
# licit, version 0.1.0

licit --verbose status
# Shows debug logs during execution

Commands

licit init

Initializes licit in the current project. Automatically detects project characteristics and generates the configuration.

licit init [--framework {eu-ai-act|owasp|all}]

Options:

What it does:

1. Runs ProjectDetector to detect languages, frameworks, CI/CD, AI agents, etc.
2. Generates .licit.yaml with configuration adapted to the project.
3. Creates the .licit/ directory for internal data.
4. If architect or vigil is detected, automatically enables their connectors.

Example:

$ cd my-fastapi-project/
$ licit init

Initialized licit in my-fastapi-project
  Languages: python
  Frameworks: fastapi
  Agent configs: CLAUDE.md
  CI/CD: github-actions
  Config saved to .licit.yaml

Example with specific framework:

$ licit init --framework eu-ai-act
# Only enables EU AI Act, disables OWASP

licit status

Shows the current status of licit and connected data sources.

licit status

What it shows:

• Project information (name, languages, frameworks)
• Configuration status
• Enabled frameworks (EU AI Act, OWASP)
• Detected data sources (provenance, FRIA, changelog, etc.)
• Configured connectors (architect, vigil)
• Detected AI agent configurations

Example:

$ licit status

Project: my-fastapi-project
  Root: /home/user/my-fastapi-project
  Languages: python
  Frameworks: fastapi
  Git: 142 commits, 3 contributors

Config: .licit.yaml (loaded)

Frameworks:
  EU AI Act: enabled
  OWASP Agentic: enabled

Data sources:
  Provenance: not collected
  FRIA: not found
  Annex IV: not found
  Changelog: not found

Connectors:
  architect: disabled
  vigil: disabled

Agent configs:
  CLAUDE.md (claude-code)
  .cursorrules (cursor)

licit connect

Configures optional connectors to integrate external data sources.

licit connect {architect|vigil} [--enable|--disable]

Arguments:

Options:

Example:

$ licit connect architect
# Enables the architect connector

$ licit connect vigil --enable
# Enables the vigil connector

$ licit connect architect --disable
# Disables the architect connector

licit trace

Tracks code provenance — identifies what was written by AI and what by humans.

Status: Registered in CLI. Functional starting from Phase 2.

licit trace [--since DATE|TAG] [--report] [--stats]

Options:

Future example:

$ licit trace --since 2026-01-01 --stats

Provenance Analysis (since 2026-01-01):
  Total files analyzed: 87
  AI-authored: 34 (39.1%)
  Human-authored: 41 (47.1%)
  Mixed: 12 (13.8%)
  Confidence: 0.82 avg

licit changelog

Generates a changelog of changes in AI agent configurations.

Status: Registered in CLI. Functional starting from Phase 3.

licit changelog [--since DATE|TAG] [--format {markdown|json}]

Options:

Monitored files:

• CLAUDE.md
• .cursorrules, .cursor/rules
• AGENTS.md
• .github/copilot-instructions.md
• .github/agents/*.md
• .architect/config.yaml, architect.yaml

licit fria

Completes the Fundamental Rights Impact Assessment (EU AI Act Article 27).

Status: Registered in CLI. Functional starting from Phase 4.

licit fria [--update]

Options:

Generated files:

• .licit/fria-data.json — Raw assessment data
• .licit/fria-report.md — Human-readable FRIA report

licit annex-iv

Generates the Annex IV Technical Documentation (EU AI Act).

Status: Registered in CLI. Functional starting from Phase 4.

licit annex-iv [--organization NAME] [--product NAME]

Options:

Generated file:

• .licit/annex-iv.md

licit report

Generates a unified compliance report.

Status: Registered in CLI. Functional starting from Phase 6.

licit report [--framework {eu-ai-act|owasp|all}] [--format {markdown|json|html}] [--output PATH]

Options:

licit gaps

Identifies compliance gaps with actionable recommendations.

Status: Registered in CLI. Functional starting from Phase 6.

licit gaps [--framework {eu-ai-act|owasp|all}]

Options:

Future example:

$ licit gaps --framework eu-ai-act

EU AI Act Compliance Gaps:

[HIGH] ART-9-1: Risk Management System
  Gap: No FRIA document found
  Action: Run 'licit fria' to complete the assessment
  Effort: medium

[MEDIUM] ART-13-1: Transparency
  Gap: No provenance tracking configured
  Action: Run 'licit trace' to analyze code provenance
  Effort: low

licit verify

Verifies compliance and returns an exit code for CI/CD.

Status: Registered in CLI. Functional starting from Phase 6.

licit verify [--framework {eu-ai-act|owasp|all}]

Exit codes:

Usage in CI/CD (GitHub Actions):

- name: Compliance check
  run: licit verify
  # The pipeline fails if exit code != 0

Command Summary Table