> ## Documentation Index
> Fetch the complete documentation index at: https://docs.complior.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> 4 commands from zero to audit-ready compliance artifacts.

Go from an unscanned project to a full compliance package in under 5 minutes.

<Steps>
  <Step title="Initialize project">
    Create the `.complior/` config directory and project profile.

    ```bash theme={null}
    complior init
    ```

    ```
    Initialized .complior/ at ./.complior
      Created: project.toml (TUI config)
      Created: profile.json (engine config)

    Run `complior` to start the dashboard, or `complior scan` to check compliance.
    ```

    <Tip>
      For interactive setup, run `complior` (TUI) — the onboarding wizard walks you through 8 steps: Theme → Project type → Trust level → Frameworks → Role → Industry → AI systems → Summary.
    </Tip>
  </Step>

  <Step title="Scan your code">
    Run 5-layer static analysis on your project. No config file needed.

    ```bash theme={null}
    complior scan
    ```

    ```
    * Complior v1.0.0  ·  EU AI Act Compliance Scanner
    --------------------------------------------------------------------------------
    Scanning  .
    Files     500 collected
    Elapsed   2.1s
    Layers    L1 File Presence · L2 Document Structure · L3 Dependencies
              · L4 Code Patterns · NHI Secrets · GPAI Systemic Risk

    --------------------------------------------------------------------------------
    COMPLIANCE SCORE                                                   40 / 100  D
    SECURITY SCORE                                                             N/A
    Run `complior eval --security <url>` for security scoring
    --------------------------------------------------------------------------------
    !! Score capped — critical violations limit maximum achievable score

    Framework Breakdown
      EU AI Act                   40 / 100   ########------------

    Layer Results
      L1    File Presence            FAIL   11 issues found
      L2    Document Structure       FAIL   7 issues found
      L3    Dependencies             WARN   1 issues found
      L4    Code Patterns            WARN   35 issues found
      NHI   Secrets                  PASS   1 checks passed
      CROSS Cross-Layer              WARN   2 issues found
      GPAI  Systemic Risk            PASS   2 checks passed

    --------------------------------------------------------------------------------
    FINDINGS  (56 total · 5 high · 42 medium)
    --------------------------------------------------------------------------------

      L1 File Presence
        F-001  !  HIGH  [L1]  Art. 26(4) · Agent Passport
           No Agent Passport found — AI SDK detected but no
           .complior/agents/*-manifest.json (Art. 26(4))
           Fix:  Run `complior agent init` to generate an Agent Passport

        F-002  !  HIGH  [L1]  Art. 6(2) · High-Risk Domain: Finance
           Code matches Finance / Credit patterns (Annex III §5(b)).
           AI system is likely high-risk under EU AI Act Art. 6(2).
           File:  src/data/industry-patterns.ts:43

      ...

    --------------------------------------------------------------------------------
    QUICK ACTIONS
    --------------------------------------------------------------------------------
    Auto-fix available        complior fix
    Deep scan                 complior scan --deep
    Full interactive view     complior tui
    Export JSON               complior scan --json > report.json

    Next: fix 5 high-severity issues to improve your score
    ```

    The scan auto-discovers AI agents and creates Agent Passports during the first run.
  </Step>

  <Step title="Auto-fix compliance issues">
    Preview what can be fixed and the predicted score impact.

    ```bash theme={null}
    complior fix --dry-run
    ```

    ```
    Dry-Run Fix Analysis (offline estimate)
    Fixable: 29 findings
    Predicted: 40 -> 72 (+32)
    ```

    Apply all fixes:

    ```bash theme={null}
    complior fix
    ```

    <Note>
      Use `complior fix --ai` to have LLM fill in document placeholders (requires `.complior/.env` with LLM config).
    </Note>
  </Step>

  <Step title="Open the dashboard">
    Launch the TUI with 9 interactive pages.

    ```bash theme={null}
    complior
    ```

    This starts the background daemon and opens the terminal dashboard. Navigate with hotkeys:

    | Key | Page        | What it shows                               |
    | --- | ----------- | ------------------------------------------- |
    | `D` | Dashboard   | Score, deadlines, AI systems, activity log  |
    | `S` | Scan        | Findings by severity, per-obligation detail |
    | `F` | Fix         | Fixable items with diff preview             |
    | `P` | Passport    | All AI systems, completeness %, obligations |
    | `O` | Obligations | 108 EU AI Act obligations with status       |
    | `T` | Timeline    | Visual countdown to Aug 2, 2026             |
    | `R` | Report      | Export: JSON, SARIF                         |
    | `L` | Log         | Daemon events, system messages              |
    | `C` | Chat        | LLM compliance assistant                    |

    ```
    TUI Dashboard — 9 pages (D/S/F/P/O/T/R/L/C)
    Press the hotkey to navigate. Press ? for help, q to quit.
    ```
  </Step>
</Steps>

## What you now have

After these 4 commands, your project contains:

```
project/
├── .complior/
│   ├── project.toml                       # Project configuration
│   ├── profile.json                       # Domain, data types, risk level
│   ├── agents/
│   │   └── my-agent-manifest.json         # Agent Passport (ed25519 signed)
│   ├── evidence/
│   │   └── chain.json                     # Tamper-proof evidence chain
│   └── reports/
│       └── scan-report.json               # Latest scan results
```

<Check>
  Every file is cryptographically linked via the evidence chain. The entire `.complior/` directory is your audit-ready compliance package.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Deep dive: Scan" icon="magnifying-glass" href="/scan/overview">
    Understand the 5 analysis layers and 6 scan tiers.
  </Card>

  <Card title="Deep dive: Eval" icon="flask-vial" href="/eval/overview">
    Test your live AI system with 680 dynamic probes.
  </Card>

  <Card title="Agent Passport" icon="id-card" href="/passport/overview">
    Explore the 36 fields, 2 generation modes, and 11-stage data pipeline.
  </Card>

  <Card title="Compliance Documents" icon="file-shield" href="/compliance-docs/overview">
    See all 6 document types Complior generates for you.
  </Card>
</CardGroup>
