Skip to content
Apothem
Référence de la CLI

verify

Référence de la CLI pour la commande apothem verify.

Vérifie l'installation d'un adaptateur d'environnement.

Synopsis

apothem verify --harness NAME|all [--profile PATH] [--project PATH]
                [--quiet|-q] [--verbose|-v]
                [--format plain|json] [--json] [--no-color]

Appelle l'implémentation verify() de chaque adaptateur sélectionné. Se termine avec le code 0 uniquement lorsque tous les adaptateurs sélectionnés signalent que leurs cibles gérées sont présentes et valides. Sans --profile, la vérification est structurelle — chaque cible gérée doit être présente et valide. Avec --profile, la vérification exige en plus la fidélité au profil : une installation présente mais qui a dérivé échoue donc à la vérification, ce qui répond à la question « CE profil est-il fidèlement installé ? » plutôt qu'à la simple question « existe-t-il ? ».

Pour un adaptateur qui écrit des skills dans votre répertoire personnel, verify vérifie aussi que chaque dossier de skill attendu existe avec un SKILL.md, quelle que soit l'installation qui l'a écrit ; une machine sur laquelle un seul des outils qui partagent un dossier est installé passe donc la vérification. La vérification échoue lorsqu'un dossier manque, et lorsqu'un dossier portant le nom d'un skill Apothem appartient à quelque chose qu'Apothem n'a pas écrit. Une ligne en échec indique le cas : en mode plain, une ligne Note: la suit, et dans la ligne JSON un objet user_level liste les chemins missing et unlisted ainsi qu'un message. Exécutez install pour restaurer un dossier manquant ; renommez ou déplacez un dossier étranger, puis exécutez update.

Un balayage --harness all respecte le champ exclude_harnesses du profil — les mêmes exclusions que celles appliquées par le lot install/update —, de sorte que verify ne signale jamais comme manquant un environnement délibérément exclu. Les exclusions proviennent de --profile lorsqu'il est fourni, sinon du profil par défaut ; un profil par défaut illisible ou absent se replie sur le registre complet.

Options

OptionDescription
--harness NAMEAdaptateur d'environnement à vérifier, ou all pour l'ensemble couvrant tout le registre (obligatoire).
--profile PATHYAML du profil partagé par rapport auquel vérifier la fidélité. Sans cette option, la vérification est purement structurelle.
--project PATHRacine du projet pour les environnements à portée de projet.
--quiet, -qSupprime la sortie informative ; seules les erreurs sont émises.
--verbose, -vÉmet une sortie de diagnostic supplémentaire.
--format plain|jsonFormat de sortie (par défaut : plain).
--jsonRaccourci de --format json.
--no-colorDésactive les codes de couleur ANSI dans la sortie.
-h, --helpAffiche l'aide et quitte.

Sortie JSON

{
  "schema_version": 1,
  "status": "success",
  "command": "verify",
  "action": "verified",
  "harness": "claude-code",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "outcome": "unchanged",
      "operation": "verify",
      "path": "C:\\Users\\Example\\.claude\\settings.json",
      "message": "managed targets verified",
      "installed": true,
      "verified": true
    }
  ],
  "warnings": [],
  "error": null,
  "installed": true,
  "verified": true,
  "output_path": "C:\\Users\\Example\\.claude\\settings.json"
}

Lorsqu'un environnement sélectionné est manquant ou invalide, status vaut error, la ligne de résultat en échec porte verified: false et le processus se termine avec le code 1.

Exemples

apothem verify --harness claude-code
apothem verify --harness claude-code --json
apothem verify --harness all --project .

Codes de sortie

CodeSignification
0Environnement vérifié — toutes les cibles gérées sont présentes et valides
1Environnement non vérifié — des cibles gérées sont manquantes ou invalides
64Erreur d'utilisation : une option ou une commande inconnue, ou une valeur d'option manquante ou invalide. Sous --json, l'erreur est une enveloppe JSON avec le code cli.usage.

Voir aussi

On this page