Skip to content
Apothem
Referencia de la CLI

status

Referencia de la CLI para el comando apothem status.

Informa el estado de instalación, verificación y deriva de cada harness registrado.

Sinopsis

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

status es un comando de inspección de solo lectura. Itera cada adaptador de harness registrado e informa tres hechos por asistente: si está instalado, si sus destinos gestionados se verifican y si la configuración instalada se ha desviado del perfil compartido. No escribe nada en disco.

Para cada harness, status informa:

ColumnaSignificado
installedLa configuración gestionada del adaptador existe en su ruta de destino.
verifiedLos destinos gestionados del adaptador están presentes y son válidos.
driftEl veredicto de fidelidad del perfil (ver abajo).

El valor de drift es uno de:

ValorSignificado
in-syncLa configuración instalada lleva textualmente el perfil compartido recién proyectado.
driftEl harness está instalado pero su contenido de perfil proyectado ya no coincide con el perfil compartido actual. Vuelve a ejecutar apothem install para reproyectar.
absentEl harness no está instalado, por lo que no hay nada que comparar.
needs-projectSe informó un harness con alcance de proyecto sin --project, por lo que su destino no puede resolverse. Pasa --project PATH para inspeccionarlo.

La deriva se informa, nunca se trata como un error: status sale con 0 incluso cuando uno o más harness informan drift. La deriva es un hecho sobre tu configuración, no un fallo del comando.

Si el perfil compartido no puede cargarse, la deriva se degrada a absent para los harness instalados (los hechos installed/verified aún se informan) en lugar de abortar el barrido.

Opciones

OpciónDescripción
--project PATHRaíz del proyecto para los harness con alcance de proyecto. Sin ella, los harness con alcance de proyecto informan needs-project.
--quiet, -qSuprime la salida informativa; solo se emiten errores.
--verbose, -vEmite salida de diagnóstico adicional.
--format plain|jsonFormato de salida (por defecto: plain).
--jsonAbreviatura de --format json.
--no-colorDesactiva los códigos de color ANSI en la salida.
-h, --helpMuestra la ayuda y sale.

Salida JSON

El sobre --json lleva una fila de resultado por cada harness registrado. Cada fila lleva las claves documentadas harness, installed, verified y 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
}

Aislamiento de fallos por adaptador: si un único adaptador lanza una excepción al informar su estado, la fila de ese harness lleva outcome: "error" y un message, los asistentes restantes siguen informando con normalidad y el proceso sale con el código 2.

Ejemplos

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

Códigos de salida

CódigoSignificado
0Estado informado (la deriva se informa, no es un error)
2Al menos un adaptador no pudo informar su estado

Véase también

On this page