# 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`      | Demande l’autorisation de lancer des analyses Pulse, des contrôles rapides et de relancer les contrôles DNS gratuits (vous la cochez dans le navigateur) |
| `--sites`      | Demande l’autorisation d’ajouter des sites et de changer votre site gratuit (vous la cochez dans le navigateur)                                          |
| `--deep`       | Demande l’autorisation de préparer des analyses Deep que vous autorisez 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\>`, ou déplace le Pulse gratuit avec `lockpick sites switch \<siteId\> --yes`

```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 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.

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

| Argument             | Ce qu’il fait                                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<target>`           | Identifiant ou nom du site ; avec --dns, 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)                              |
| `--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, requirements.txt et poetry.lock (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 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                                                                               |
| `--browser-artifacts <value>` | Répertoire des fichiers destinés au navigateur, relatif au dépôt ; option répétable                                   |
| `--env-file <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)             |
| `--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                                         |
| `--fail-on <value>`           | Code 8 lorsque les points à corriger ouverts sont de cette gravité ou plus : critical, high, medium, low (pour la CI) |

## 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 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) |