# Commandes

Chaque commande lockpick et ses options, générées à partir de la CLI elle-même.

{/* Generated by scripts/docs-generate.mts. Do not edit; run `pnpm docs:generate`. */}

Lockpick depuis votre terminal : contrôles rapides, sites, états, points à corriger, briefs de correction, analyses Pulse, analyses Deep que vous autorisez, et contrôles à nouveau pour vous et vos agents de code.

Exécutez `lockpick <command> --help` pour voir les mêmes options dans votre terminal. Chaque commande accepte aussi `--host` et `--json`.

## lockpick login

Se connecter via le navigateur et enregistrer une clé pour un espace de travail

```bash title="Utilisation"
lockpick login [options]
```

| Argument       | Ce qu’il fait                                                                                                                                                                                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--no-browser` | Affiche le lien de connexion sans ouvrir le navigateur                                                                                                                                                                                                  |
| `--pulse`      | Demander l’autorisation de lancer des analyses Pulse, des vérifications rapides et des vérifications DNS gratuites, de définir ou suspendre des vérifications automatiques Pulse et de partager des résultats Pulse (vous la cochez dans le navigateur) |
| `--sites`      | Demande l’autorisation d’ajouter des sites, de changer votre site gratuit et d’importer les constats acceptés ou écartés (vous la cochez dans le navigateur)                                                                                            |
| `--deep`       | Demander l’autorisation de préparer des analyses Deep et des vérifications automatiques Deep que vous approuvez dans Lockpick (vous la cochez dans le navigateur)                                                                                       |
| `--local`      | Demander l’autorisation pour les évaluations locales                                                                                                                                                                                                    |

## lockpick logout

Révoquer la clé de ce terminal et l’oublier

```bash title="Utilisation"
lockpick logout
```

## lockpick whoami

Affiche l’utilisateur, l’espace de travail et la clé utilisés par ce terminal

```bash title="Utilisation"
lockpick whoami
```

## lockpick doctor

Vérifie la CLI, l’hôte, la connexion, l’authentification et l’accès à l’espace de travail, sans lancer d’analyse

```bash title="Utilisation"
lockpick doctor [options]
```

| Argument          | Ce qu’il fait                                   |
| ----------------- | ----------------------------------------------- |
| `--scope <value>` | Portée à vérifier : pulse, sites, deep ou local |

## lockpick projects

Liste les projets avec leurs dernières analyses Pulse et Deep

```bash title="Utilisation"
lockpick projects
```

## lockpick status

Rapport d’état d’un projet (ou une vue d’ensemble de tous les projets)

```bash title="Utilisation"
lockpick status [project]
```

| Argument    | Ce qu’il fait                |
| ----------- | ---------------------------- |
| `<project>` | Identifiant ou nom du projet |

## lockpick sites

Liste les sites, en ajoute un avec `lockpick sites add \<url\>`, déplace le Pulse gratuit avec `lockpick sites switch \<siteId\> --yes`, ou lit l’historique d’un site avec `lockpick sites history \<site\>`

```bash title="Utilisation"
lockpick sites
```

## lockpick sites add

Ajoute un site que vous possédez ou êtes autorisé à tester (nécessite une clé autorisée à ajouter des sites). Ajouter un site ne l’analyse pas.

```bash title="Utilisation"
lockpick sites add <url> [options]
```

| Argument         | Ce qu’il fait                                                               |
| ---------------- | --------------------------------------------------------------------------- |
| `<url>`          | Adresse du site, par exemple [https://atlas.example](https://atlas.example) |
| `--name <value>` | Nom affiché dans Lockpick                                                   |

## lockpick sites switch

Retire le site qui détient le Pulse gratuit du mois pour qu’un autre site puisse l’utiliser (nécessite une clé autorisée à ajouter des sites et à lancer un Pulse). Avec --check, lance aussi un Pulse sur le site de ce contrôle rapide, en utilisant un Pulse gratuit.

```bash title="Utilisation"
lockpick sites switch <site> [options]
```

| Argument          | Ce qu’il fait                                                                           |
| ----------------- | --------------------------------------------------------------------------------------- |
| `<site>`          | Identifiant du site à retirer (depuis `lockpick sites`)                                 |
| `--check <value>` | Identifiant du contrôle rapide du nouveau site ; son Pulse démarre avec le changement   |
| `--yes`           | Confirme le retrait. Le site n’est plus surveillé ; il peut être restauré dans Lockpick |

## lockpick sites history

L’historique de sécurité d’un site : l’évolution du score de chaque profondeur de scan, interrompue là où le moteur a changé, les constats ouverts au fil du temps, les corrections, les régressions et le délai médian de correction

```bash title="Utilisation"
lockpick sites history <site>
```

| Argument | Ce qu’il fait                                        |
| -------- | ---------------------------------------------------- |
| `<site>` | Identifiant ou nom du site (depuis `lockpick sites`) |

## lockpick runs

Liste les analyses Pulse et Deep, les plus récentes en premier

```bash title="Utilisation"
lockpick runs [options]
```

| Argument            | Ce qu’il fait                                                                     |
| ------------------- | --------------------------------------------------------------------------------- |
| `--project <value>` | Identifiant ou nom du projet                                                      |
| `--kind <value>`    | pulse \| box                                                                      |
| `--status <value>`  | queued \| running \| cancelling \| succeeded \| incomplete \| failed \| cancelled |
| `--limit <value>`   | Nombre à afficher (20 par défaut, 100 au maximum)                                 |

## lockpick run

Affiche une analyse

```bash title="Utilisation"
lockpick run <runId>
```

| Argument  | Ce qu’il fait            |
| --------- | ------------------------ |
| `<runId>` | Identifiant de l’analyse |

## lockpick watch

Suit une analyse jusqu’à sa fin (code 3 sauf en cas de succès)

```bash title="Utilisation"
lockpick watch <runId> [options]
```

| Argument             | Ce qu’il fait                                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `<runId>`            | Identifiant de l’analyse                                                                                              |
| `--fail-on <value>`  | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI) |
| `--interval <value>` | Secondes entre deux vérifications (5 par défaut, jusqu’à 30)                                                          |
| `--timeout <value>`  | Attente maximale en secondes (600 par défaut, 3600 au maximum)                                                        |

## lockpick pulse

Lance une analyse Pulse sur un projet et attend le résultat (nécessite une clé autorisée à lancer des Pulse)

```bash title="Utilisation"
lockpick pulse <project> [options]
```

| Argument             | Ce qu’il fait                                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<project>`          | Identifiant ou nom du projet                                                                                                                                     |
| `--no-wait`          | Renvoie dès le lancement de l’analyse, sans attendre le résultat                                                                                                 |
| `--interval <value>` | Secondes entre deux vérifications pendant l’attente (5 par défaut)                                                                                               |
| `--timeout <value>`  | Attente maximale en secondes (600 par défaut, 3600 au maximum)                                                                                                   |
| `--fail-on <value>`  | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI)                                            |
| `--lockfile`         | Envoie (ou, avec --no-lockfile, n’envoie jamais) les noms et versions des paquets de ce dossier pour cette analyse ; sinon Lockpick demande une fois par dossier |

## lockpick recheck

Contrôle complet d’un site : un nouveau Pulse qui utilise une analyse Pulse du quota. Avec --dns \<findingId>, relance gratuitement le contrôle DNS d’un point à corriger d’une analyse, ce qui ne modifie jamais sa note. Avec --finding \<findingId>, « Vérifier ce correctif » : un contrôle gratuit d’un point à corriger d’une analyse Deep, qui relit uniquement ce sur quoi il a été vu (limité chaque jour).

```bash title="Utilisation"
lockpick recheck <target> [options]
```

| Argument             | Ce qu’il fait                                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<target>`           | Identifiant ou nom du site ; avec --dns ou --finding, l’identifiant de l’analyse                                                                                 |
| `--dns <value>`      | Identifiant du point à corriger à contrôler à nouveau d’après les enregistrements DNS publics (gratuit, ne contacte jamais le site)                              |
| `--finding <value>`  | Identifiant du point à corriger Deep à vérifier après un correctif (gratuit, limité chaque jour ; relit uniquement ce sur quoi il a été vu)                      |
| `--no-wait`          | Renvoie dès le lancement de l’analyse, sans attendre le résultat                                                                                                 |
| `--interval <value>` | Secondes entre deux vérifications pendant l’attente (5 par défaut)                                                                                               |
| `--timeout <value>`  | Attente maximale en secondes (600 par défaut, 3600 au maximum)                                                                                                   |
| `--fail-on <value>`  | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI)                                            |
| `--lockfile`         | Envoie (ou, avec --no-lockfile, n’envoie jamais) les noms et versions des paquets de ce dossier pour cette analyse ; sinon Lockpick demande une fois par dossier |

## lockpick deps

Envoie à un site les noms et versions exactes des paquets de ce projet (jamais le code), et liste les avis qui les concernent. Lit package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock, bun.lock, requirements.txt, poetry.lock, uv.lock, Pipfile.lock, pdm.lock, composer.lock, go.mod, Gemfile.lock, gems.locked, gradle.lockfile, Cargo.lock, packages.lock.json, pubspec.lock, mix.lock, Package.resolved et pom.xml (nécessite une clé autorisée à gérer des sites).

```bash title="Utilisation"
lockpick deps <site> [options]
```

| Argument                 | Ce qu’il fait                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------- |
| `<site>`                 | Identifiant ou nom du site                                                                              |
| `--path <value>`         | Dossier du projet contenant les fichiers de verrouillage (par défaut : ce dossier)                      |
| `--completeness <value>` | complete, partial ou unknown (unknown par défaut ; ne déclarez complete que pour un inventaire complet) |
| `--revision <value>`     | Révision de source facultative ; ne prouve pas le déploiement                                           |
| `--environment <value>`  | production, staging, development ou unknown                                                             |
| `--dry-run`              | Affiche seulement ce qui serait envoyé                                                                  |
| `--forget`               | Supprime la liste de paquets du site dans Lockpick                                                      |

## lockpick github status

Affiche le dépôt lié à un site, sa branche, ses fichiers de verrouillage, la dernière lecture et les commentaires de pull request, et indique si votre liste GitHub est à jour

```bash title="Utilisation"
lockpick github status [target] [options]
```

| Argument         | Ce qu’il fait                                              |
| ---------------- | ---------------------------------------------------------- |
| `<target>`       | Identifiant ou nom du site                                 |
| `--site <value>` | Identifiant ou nom du site (identique au site positionnel) |

## lockpick github repos

Liste les dépôts GitHub auxquels vous pouvez lier un site

```bash title="Utilisation"
lockpick github repos [options]
```

| Argument           | Ce qu’il fait                                      |
| ------------------ | -------------------------------------------------- |
| `--search <value>` | Seulement les dépôts dont le nom contient ce texte |
| `--limit <value>`  | Nombre à afficher (de 1 à 100, 50 par défaut)      |

## lockpick github link

Lie un site à un dépôt GitHub ; quand GitHub a besoin de vous, ouvre une page d’approbation et attend votre décision

```bash title="Utilisation"
lockpick github link [target] [options]
```

| Argument                | Ce qu’il fait                                                                                                                                                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<target>`              | Identifiant ou nom du site                                                                                                                                                                                                       |
| `--site <value>`        | Identifiant ou nom du site (identique au site positionnel)                                                                                                                                                                       |
| `--repo <value>`        | Le dépôt sous la forme owner/name (obligatoire)                                                                                                                                                                                  |
| `--ref <value>`         | Branche, tag ou commit à lire (par défaut : la branche par défaut du dépôt)                                                                                                                                                      |
| `--lockfile <value>`    | Chemin d’un lockfile du dépôt à vérifier ; à répéter pour plusieurs (20 au maximum), conservés tels que choisis. Sans cette option ni --lockfiles, un nouveau lien conserve une liste choisie, sinon chaque lockfile est vérifié |
| `--lockfiles <value>`   | auto : vérifier chaque lockfile du dépôt, recherché de nouveau à chaque lecture (remplace une liste choisie)                                                                                                                     |
| `--pr-comments <value>` | Le commentaire de pull request Deep pour ce lien : on (par défaut ; en pause sans Deep) ou off                                                                                                                                   |
| `--no-open`             | Affiche la page d’approbation au lieu d’ouvrir un navigateur                                                                                                                                                                     |
| `--no-wait`             | Affiche la page d’approbation et l’identifiant de la demande, puis rend la main aussitôt                                                                                                                                         |

## lockpick github unlink

Délie un site de son dépôt GitHub

```bash title="Utilisation"
lockpick github unlink [target] [options]
```

| Argument         | Ce qu’il fait                                              |
| ---------------- | ---------------------------------------------------------- |
| `<target>`       | Identifiant ou nom du site                                 |
| `--site <value>` | Identifiant ou nom du site (identique au site positionnel) |

## lockpick github pr-comments

Active ou désactive le commentaire de sécurité Deep sur les pull requests d’un site

```bash title="Utilisation"
lockpick github pr-comments [target] [state] [options]
```

| Argument         | Ce qu’il fait                                              |
| ---------------- | ---------------------------------------------------------- |
| `<target>`       | Identifiant ou nom du site                                 |
| `<state>`        | `on` ou `off`                                              |
| `--site <value>` | Identifiant ou nom du site (identique au site positionnel) |

## lockpick schedule status

Affiche les contrôles automatiques Pulse et Deep d’un site et les fréquences que son forfait autorise

```bash title="Utilisation"
lockpick schedule status <site>
```

| Argument | Ce qu’il fait              |
| -------- | -------------------------- |
| `<site>` | Identifiant ou nom du site |

## lockpick schedule set

Configure ou modifie le contrôle automatique d’un site ; Pulse change aussitôt, Deep (--deep) ouvre une page d’autorisation et attend votre décision

```bash title="Utilisation"
lockpick schedule set <site> [options]
```

| Argument          | Ce qu’il fait                                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `<site>`          | Identifiant ou nom du site                                                                                                        |
| `--every <value>` | La fréquence d’exécution : daily \| weekly \| monthly                                                                             |
| `--at <value>`    | L’heure UTC visée pour les exécutions, de 0 à 23                                                                                  |
| `--any-time`      | S’exécute à n’importe quelle heure de la journée (efface l’heure)                                                                 |
| `--deep`          | Agit sur le contrôle automatique Deep au lieu de Pulse (le configurer ou le reprendre nécessite votre autorisation dans Lockpick) |
| `--no-open`       | Affiche la page d’approbation au lieu d’ouvrir un navigateur                                                                      |
| `--no-wait`       | Affiche la page d’approbation et l’identifiant de la demande, puis rend la main aussitôt                                          |

## lockpick schedule pause

Met en pause le contrôle automatique Pulse d’un site, ou son contrôle Deep avec --deep

```bash title="Utilisation"
lockpick schedule pause <site> [options]
```

| Argument | Ce qu’il fait                                                                                                                     |
| -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `<site>` | Identifiant ou nom du site                                                                                                        |
| `--deep` | Agit sur le contrôle automatique Deep au lieu de Pulse (le configurer ou le reprendre nécessite votre autorisation dans Lockpick) |

## lockpick schedule resume

Reprend un contrôle automatique en pause ou retiré avec sa fréquence ; Deep (--deep) nécessite votre autorisation dans Lockpick

```bash title="Utilisation"
lockpick schedule resume <site> [options]
```

| Argument    | Ce qu’il fait                                                                                                                     |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `<site>`    | Identifiant ou nom du site                                                                                                        |
| `--deep`    | Agit sur le contrôle automatique Deep au lieu de Pulse (le configurer ou le reprendre nécessite votre autorisation dans Lockpick) |
| `--no-open` | Affiche la page d’approbation au lieu d’ouvrir un navigateur                                                                      |
| `--no-wait` | Affiche la page d’approbation et l’identifiant de la demande, puis rend la main aussitôt                                          |

## lockpick share list

Liste les résultats Pulse d’un site qui ont un lien public actif

```bash title="Utilisation"
lockpick share list <site>
```

| Argument | Ce qu’il fait              |
| -------- | -------------------------- |
| `<site>` | Identifiant ou nom du site |

## lockpick share create

Publie un résultat Pulse terminé à un lien public ; Lockpick n’affiche le lien qu’une seule fois

```bash title="Utilisation"
lockpick share create <runId> [options]
```

| Argument    | Ce qu’il fait                                        |
| ----------- | ---------------------------------------------------- |
| `<runId>`   | Identifiant de l’analyse Pulse (exécution)           |
| `--replace` | Crée un nouveau lien ; l’ancien cesse de fonctionner |

## lockpick share revoke

Arrête le partage d’un résultat Pulse ; son lien public cesse de fonctionner

```bash title="Utilisation"
lockpick share revoke <runId>
```

| Argument  | Ce qu’il fait                              |
| --------- | ------------------------------------------ |
| `<runId>` | Identifiant de l’analyse Pulse (exécution) |

## lockpick monitor

Parcourt les avis de sécurité actuels et les correspondances pour les sites que vous pouvez lire.

```bash title="Utilisation"
lockpick monitor [options]
```

| Argument              | Ce qu’il fait                                            |
| --------------------- | -------------------------------------------------------- |
| `--site <value>`      | Filtre sur un identifiant ou un nom de site              |
| `--query <value>`     | Recherche par identifiant d’avis, titre ou nom de paquet |
| `--ecosystem <value>` | all, npm, pypi, composer ou wordpress                    |
| `--kind <value>`      | all, vulnerability ou malicious_package                  |
| `--view <value>`      | latest, sites, exploited ou following                    |
| `--severity <value>`  | all, critical, high, medium, low ou unknown              |
| `--days <value>`      | 7, 30, 90, 365 ou 0 pour tout l’historique               |
| `--cursor <value>`    | Curseur suivant d’une réponse précédente                 |
| `--advisory <value>`  | Lit un identifiant d’avis                                |

## lockpick check

Contrôle rapide gratuit d’un site web (page d’accueil et DNS public), ou d’un dépôt GitHub public avant de l’installer : un skill, un plugin, un serveur MCP ou une application (nécessite une clé autorisée à lancer des Pulse)

```bash title="Utilisation"
lockpick check <url> [options]
```

| Argument            | Ce qu’il fait                                                                                                                                                                                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<url>`             | Adresse du site web (atlas.example) ou dépôt GitHub (github.com/owner/repo, owner/repo)                                                                                                                                             |
| `--no-wait`         | Renvoie dès le lancement de l’analyse, sans attendre le résultat                                                                                                                                                                    |
| `--timeout <value>` | Attente maximale en secondes (90 par défaut, 3600 au maximum)                                                                                                                                                                       |
| `--deep`            | Pour un dépôt GitHub : une vérification Deep du dépôt. Elle lit aussi chaque lockfile et les 50 derniers commits à la recherche de clés divulguées, avec une revue plus poussée. Nécessite le forfait Deep et utilise un scan Deep. |

## lockpick verify

Vérifie une fois que vous possédez un site. Affiche la valeur du site et l’endroit où la publier ; --wait la recherche (nécessite une clé autorisée à préparer des analyses Deep)

```bash title="Utilisation"
lockpick verify <site> [options]
```

| Argument           | Ce qu’il fait                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| `<site>`           | Identifiant ou nom du site                                                                               |
| `--method <value>` | dns (par défaut), file ou meta (une balise dans l’en-tête de la page d’accueil) Valeur par défaut `dns`. |
| `--wait`           | Continue de la chercher pendant environ cinq minutes (utilise les vérifications de la preuve)            |

## lockpick deep local

Exécuter des contrôles locaux déterministes après autorisation du projet

```bash title="Utilisation"
lockpick deep local <path> [options]
```

| Argument                      | Ce qu’il fait                                                                                                                                                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `<path>`                      | Chemin physique du dépôt (pwd -P) ; aucun lien symbolique à la racine                                                                                                                                                          |
| `--project <value>`           | Identifiant du projet ou nom non ambigu                                                                                                                                                                                        |
| `--dismissals <value>`        | Acceptés / écartés (JSON)                                                                                                                                                                                                      |
| `--baseline <value>`          | Rapport deep local --json précédent à comparer : les constats sont marqués nouveaux ou inchangés et les constats corrigés sont listés                                                                                          |
| `--browser-artifacts <value>` | Répertoire des fichiers destinés au navigateur, relatif au dépôt ; option répétable                                                                                                                                            |
| `--dotenv <value>`            | Fichier d’environnement explicite, relatif au dépôt ; option répétable                                                                                                                                                         |
| `--dockerfile <value>`        | Chemin du Dockerfile relatif au dépôt ; répétable                                                                                                                                                                              |
| `--migration-file <value>`    | Fichier de migration SQL relatif au dépôt ; répéter dans l’ordre d’exécution                                                                                                                                                   |
| `--build-context <value>`     | Contexte de construction relatif au dépôt ; associer à --dockerfile dans le même ordre (. pour la racine)                                                                                                                      |
| `--config-file <value>`       | Fichier de configuration de déploiement relatif au dépôt, sous la forme \<family>:\<path> (actions-policy, compose-policy ou hosting-config) ; ajoute cette vérification                                                       |
| `--checks <value>`            | Identifiants de contrôles séparés par des virgules ; les contrôles demandés non pris en charge restent incomplets                                                                                                              |
| `--history`                   | Inclure une inspection limitée de l’historique Git                                                                                                                                                                             |
| `--source-maps`               | Inspecter les sources intégrées aux fichiers source map du navigateur fournis                                                                                                                                                  |
| `--php-version`               | Lire la version de PHP dans les fichiers suivis et la vérifier pour php2shell (CVE-2026-109618, CVE-2026-109619)                                                                                                               |
| `--fail-on <value>`           | Quitter avec le code 8 si des constats ouverts sont de ce niveau de gravité ou plus : critical, high, medium, low ; ajoutez new (répétez l’option ou utilisez high,new) pour ne compter que les constats absents de --baseline |

## lockpick deep verify

Démarre une preuve de propriété pour une analyse Deep : un enregistrement DNS TXT, un fichier ou une balise meta de la page d’accueil que vous publiez (nécessite une clé autorisée à préparer des analyses Deep)

```bash title="Utilisation"
lockpick deep verify <site> [options]
```

| Argument           | Ce qu’il fait                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| `<site>`           | Identifiant ou nom du site                                                                               |
| `--method <value>` | dns (par défaut), file ou meta (une balise dans l’en-tête de la page d’accueil) Valeur par défaut `dns`. |
| `--wait`           | Continue de la chercher pendant environ cinq minutes (utilise les vérifications de la preuve)            |

## lockpick deep check

Recherche une fois une preuve de propriété publiée (chaque vérification utilise une de ses tentatives)

```bash title="Utilisation"
lockpick deep check <site> <verificationId>
```

| Argument           | Ce qu’il fait                                  |
| ------------------ | ---------------------------------------------- |
| `<site>`           | Identifiant ou nom du site                     |
| `<verificationId>` | L’identifiant renvoyé par lockpick deep verify |

## lockpick deep prepare

Prépare une analyse Deep avec une preuve vérifiée et ouvre sa page d’autorisation ; rien ne démarre tant que vous ne l’autorisez pas dans Lockpick

```bash title="Utilisation"
lockpick deep prepare <site> <verificationId> [options]
```

| Argument           | Ce qu’il fait                                            |
| ------------------ | -------------------------------------------------------- |
| `<site>`           | Identifiant ou nom du site                               |
| `<verificationId>` | L’identifiant de la preuve vérifiée                      |
| `--no-browser`     | Affiche le lien d’autorisation sans ouvrir le navigateur |

## lockpick deep start

Lance une analyse Deep que vous avez autorisée dans Lockpick et attend son résultat (une analyse Deep du quota, comme affiché lors de la préparation)

```bash title="Utilisation"
lockpick deep start <operationId> [options]
```

| Argument             | Ce qu’il fait                                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `<operationId>`      | L’identifiant renvoyé par lockpick deep prepare                                                                       |
| `--no-wait`          | Renvoie dès le lancement de l’analyse, sans attendre le résultat                                                      |
| `--interval <value>` | Secondes entre deux vérifications pendant l’attente (5 par défaut)                                                    |
| `--timeout <value>`  | Attente maximale en secondes (600 par défaut, 3600 au maximum)                                                        |
| `--fail-on <value>`  | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI) |

## lockpick findings

Points à corriger d’une analyse qui demandent une action

```bash title="Utilisation"
lockpick findings <runId> [options]
```

| Argument             | Ce qu’il fait                                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `<runId>`            | Identifiant de l’analyse                                                                                              |
| `--severity <value>` | critical \| high \| medium \| low \| info                                                                             |
| `--all`              | Inclut les contrôles réussis et non évalués                                                                           |
| `--fail-on <value>`  | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI) |

## lockpick report

Exporte une évaluation existante et ses points à corriger masqués en Markdown ou en JSON

```bash title="Utilisation"
lockpick report <runId> [options]
```

| Argument        | Ce qu’il fait                                                             |
| --------------- | ------------------------------------------------------------------------- |
| `<runId>`       | Identifiant de l’analyse                                                  |
| `--out <value>` | Crée un nouveau fichier de rapport ; refuse d’écraser un fichier existant |

## lockpick export

Enregistre une analyse terminée en PDF : en mots simples pour les clients, ou technique avec --technical

```bash title="Utilisation"
lockpick export <runId> [options]
```

| Argument        | Ce qu’il fait                                                                               |
| --------------- | ------------------------------------------------------------------------------------------- |
| `<runId>`       | Identifiant de l’analyse                                                                    |
| `--out <value>` | Le fichier PDF à créer (obligatoire) ; refuse de remplacer un fichier existant sans --force |
| `--technical`   | Le rapport technique pour les ingénieurs au lieu des mots simples                           |
| `--force`       | Remplace le fichier s’il existe déjà                                                        |

## lockpick finding

Affiche un point à corriger avec ses preuves

```bash title="Utilisation"
lockpick finding <runId> <findingId>
```

| Argument      | Ce qu’il fait                                   |
| ------------- | ----------------------------------------------- |
| `<runId>`     | Identifiant de l’analyse                        |
| `<findingId>` | Identifiant du point à corriger ou son code LP- |

## lockpick brief

Brief Markdown qui corrige tout ce qui demande une action dans une analyse (ou un seul point à corriger)

```bash title="Utilisation"
lockpick brief <runId> [options]
```

| Argument            | Ce qu’il fait                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| `<runId>`           | Identifiant de l’analyse                                                                              |
| `--finding <value>` | Ce seul point à corriger                                                                              |
| `--agent <value>`   | Adapte le brief à cet agent : claude-code, codex, cursor, vscode, opencode, lovable, bolt, replit, v0 |
| `--out <value>`     | Écrit le Markdown dans ce fichier                                                                     |

## lockpick fix

Enregistre le brief de correction global dans lockpick-fixes.md et affiche la commande qui lance votre agent dessus

```bash title="Utilisation"
lockpick fix <runId> [options]
```

| Argument          | Ce qu’il fait                                                                                         |
| ----------------- | ----------------------------------------------------------------------------------------------------- |
| `<runId>`         | Identifiant de l’analyse                                                                              |
| `--agent <value>` | Adapte le brief à cet agent : claude-code, codex, cursor, vscode, opencode, lovable, bolt, replit, v0 |
| `--out <value>`   | Où enregistrer le brief (par défaut : lockpick-fixes.md)                                              |

## lockpick compare

Compare un contrôle Pulse à nouveau avec sa référence

```bash title="Utilisation"
lockpick compare <runId>
```

| Argument  | Ce qu’il fait                                  |
| --------- | ---------------------------------------------- |
| `<runId>` | Identifiant de l’analyse de contrôle à nouveau |

## lockpick import

Lit un fichier findings.json de Codex Security ou SARIF et le corrèle avec une analyse, sur votre machine

```bash title="Utilisation"
lockpick import <file> [options]
```

| Argument        | Ce qu’il fait                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `<file>`        | Chemin vers findings.json ou un fichier SARIF 2.1.0                                                                            |
| `--run <value>` | Corrèle avec cet identifiant d’analyse (omettez-le pour seulement lire le fichier)                                             |
| `--upload`      | Crée les clés de corrélation minimales (chemins de routes, identifiants de règles, gravités) à partager ; désactivé par défaut |

## lockpick open

Ouvre une analyse ou un projet dans le navigateur

```bash title="Utilisation"
lockpick open <id>
```

| Argument | Ce qu’il fait                                       |
| -------- | --------------------------------------------------- |
| `<id>`   | Identifiant d’analyse, identifiant ou nom de projet |

## lockpick mcp

Exécute le serveur MCP sur stdio pour un agent de code

```bash title="Utilisation"
lockpick mcp [options]
```

| Argument               | Ce qu’il fait                                                       |
| ---------------------- | ------------------------------------------------------------------- |
| `--local-root <value>` | Racine locale absolue à autoriser pour les analyses MCP ; répétable |

## lockpick mcp config

Affiche la configuration MCP pour claude, cursor, vscode, codex

```bash title="Utilisation"
lockpick mcp config <client> [options]
```

| Argument               | Ce qu’il fait                                                                           |
| ---------------------- | --------------------------------------------------------------------------------------- |
| `<client>`             | claude \| cursor \| vscode \| codex                                                     |
| `--local-root <value>` | Racine locale absolue à autoriser pour les analyses MCP ; répétable                     |
| `--hosted`             | Utilise le connecteur OAuth hébergé au lieu du serveur stdio local                      |
| `--apply`              | Fusionne dans la configuration Cursor, VS Code ou Codex, avec une sauvegarde privée     |
| `--file <value>`       | Fichier de configuration à mettre à jour avec --apply (emplacement standard par défaut) |

## lockpick mcp rollback

Restaure une sauvegarde de configuration MCP Lockpick si elle n’a pas changé depuis la configuration

```bash title="Utilisation"
lockpick mcp rollback <backup>
```

| Argument   | Ce qu’il fait                                          |
| ---------- | ------------------------------------------------------ |
| `<backup>` | Chemin de la sauvegarde affiché par mcp config --apply |

## lockpick skills

Ajoute les skills Lockpick à votre agent de code (npx skills add promptadvisers/lockpick-skills)

```bash title="Utilisation"
lockpick skills [options]
```

| Argument          | Ce qu’il fait                                                                      |
| ----------------- | ---------------------------------------------------------------------------------- |
| `--agent <value>` | Agents auxquels les ajouter, par exemple claude-code,codex (par défaut : demander) |
| `--global`        | Les ajoute pour votre utilisateur au lieu de ce projet                             |

## lockpick docs

Recherche dans la documentation Lockpick depuis le terminal, ou liste les guides de la CLI (--open ouvre le premier résultat)

```bash title="Utilisation"
lockpick docs [query] [options]
```

| Argument  | Ce qu’il fait                                                         |
| --------- | --------------------------------------------------------------------- |
| `<query>` | Ce qu’il faut chercher, par exemple « corriger un CSP manquant »      |
| `--open`  | Ouvre le meilleur résultat (ou le guide de la CLI) dans le navigateur |

## lockpick ci init

Écrit un workflow GitHub Actions (.github/workflows/lockpick.yml) qui lance une analyse Pulse à chaque version et échoue sur les points graves

```bash title="Utilisation"
lockpick ci init <site> [options]
```

| Argument            | Ce qu’il fait                                                                                                               |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `<site>`            | Identifiant ou nom du site à contrôler                                                                                      |
| `--fail-on <value>` | Fait échouer le workflow à cette gravité ou plus : critical, high, medium, low (par défaut high). Valeur par défaut `high`. |
| `--file <value>`    | Où l’écrire (par défaut .github/workflows/lockpick.yml)                                                                     |
| `--action`          | Utilise l’action GitHub Lockpick au lieu d’exécuter la CLI avec npx (aperçu)                                                |
| `--force`           | Remplace un fichier de workflow existant                                                                                    |
| `--dry-run`         | Affiche le workflow au lieu de l’écrire                                                                                     |

## lockpick ci check

Contrôle une évaluation existante sans lancer d’analyse ni consommer de quota

```bash title="Utilisation"
lockpick ci check <runId> [options]
```

| Argument                  | Ce qu’il fait                                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `<runId>`                 | Identifiant exact de l’analyse à évaluer                                                                              |
| `--max-age-hours <value>` | Âge maximal depuis la fin, en heures (facultatif)                                                                     |
| `--min-coverage <value>`  | Pourcentage de couverture minimal indiqué ; une couverture inconnue échoue (facultatif)                               |
| `--fail-on <value>`       | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI) |

## lockpick dismissals

Gérez les constats acceptés et leurs motifs pour ce projet. Annuler réactive un constat ; une modification des preuves ou des règles exige un nouvel examen.

```bash title="Utilisation"
lockpick dismissals [options]
```

| Argument            | Ce qu’il fait                            |
| ------------------- | ---------------------------------------- |
| `--project <value>` | Identifiant du projet ou nom non ambigu  |
| `--file <value>`    | Acceptés / écartés (JSON)                |
| `--push`            | Enregistrer les modifications → Lockpick |