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

status

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

Signale l'état d'installation, de vérification et de dérive de chaque harness enregistré.

Synopsis

apothem status [--project PATH]
               [--quiet|-q] [--verbose|-v]
               [--format plain|json] [--json] [--no-color]

status est une commande d'inspection en lecture seule. Elle parcourt chaque adaptateur de harness enregistré et signale trois faits par assistant : s'il est installé, si ses cibles gérées se vérifient et si la configuration installée a dérivé du profil partagé. Elle n'écrit rien sur le disque.

Pour chaque harness, status signale :

ColonneSignification
installedLa configuration gérée de l'adaptateur existe à son chemin cible.
verifiedLes cibles gérées de l'adaptateur sont présentes et valides.
driftLe verdict de fidélité du profil (voir ci-dessous).

La valeur de drift est l'une des suivantes :

ValeurSignification
in-syncLa configuration installée porte textuellement le profil partagé fraîchement projeté.
driftLe harness est installé mais son contenu de profil projeté ne correspond plus au profil partagé actuel. Relancez apothem install pour reprojeter.
absentLe harness n'est pas installé, il n'y a donc rien à comparer.
needs-projectUn harness à portée de projet a été signalé sans --project, sa cible ne peut donc pas être résolue. Passez --project PATH pour l'inspecter.

La dérive est signalée, jamais traitée comme une erreur : status se termine avec 0 même lorsqu'un ou plusieurs harness signalent drift. La dérive est un fait sur votre configuration, pas un échec de la commande.

Si le profil partagé ne peut pas être chargé, la dérive est dégradée en absent pour les harness installés (les faits installed/verified sont toujours signalés) plutôt que d'interrompre le balayage.

Options

OptionDescription
--project PATHRacine de projet pour les harness à portée de projet. Sans elle, les harness à portée de projet signalent needs-project.
--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 pour --format json.
--no-colorDésactive les codes de couleur ANSI dans la sortie.
-h, --helpAffiche l'aide et quitte.

Sortie JSON

L'enveloppe --json porte une ligne de résultat par harness enregistré. Chaque ligne porte les clés documentées harness, installed, verified et drift.

{
  "status": "success",
  "command": "status",
  "action": "status",
  "harness": "all",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "installed": true,
      "verified": true,
      "drift": "in-sync"
    },
    {
      "harness": "cursor",
      "installed": false,
      "verified": false,
      "drift": "needs-project"
    }
  ],
  "warnings": [],
  "error": null
}

Isolation des défaillances par adaptateur : si un seul adaptateur lève une exception en signalant son état, la ligne de cet harness porte outcome: "error" et un message, les assistants restants continuent de signaler normalement, et le processus se termine avec le code 2.

Exemples

apothem status
apothem status --project .
apothem status --json

Codes de sortie

CodeSignification
0État signalé (la dérive est signalée, pas une erreur)
2Au moins un adaptateur n'a pas pu signaler son état

Voir aussi

On this page