update
Referencia de la CLI para el comando apothem update.
Reinstala la configuración de un adaptador de entorno a partir del perfil compartido actual.
Sinopsis
apothem update --harness NAME|all [--profile PATH] [--dry-run]
[--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]update vuelve a materializar la salida del entorno a partir del perfil
compartido actual. Usa la misma validación del perfil, la misma selección con
--harness all, la misma comprobación del alcance de proyecto, el mismo
comportamiento de ejecución en seco y el mismo sobre JSON que install.
Para los adaptadores de alcance de proyecto que escriben skills en tu directorio
personal (consulta
install),
update también actualiza esas carpetas e imprime la misma Note: que las
nombra. Un adaptador instalado antes de que escribiera skills las recibe en su
siguiente actualización. Una carpeta de skill que Apothem no escribió se omite
con una advertencia, igual que con install.
Una instalación que antes escribió la carpeta de skills compartida se reescribe
en la forma que comparten todas las instalaciones en su siguiente actualización;
cada carpeta modificada se respalda primero.
El alias en forma continua apothem updating (también aceptado como
apothem Updating) se resuelve en el mismo manejador.
Opciones
| Opción | Descripción |
|---|---|
--harness NAME | Adaptador de entorno que se actualiza, o all para el conjunto de todo el registro (obligatorio). Con all, se omiten los entornos listados en exclude_harnesses del perfil, pero un entorno indicado explícitamente se actualiza aunque figure en la lista. |
--profile PATH | Ruta al YAML del perfil compartido. Valor predeterminado: ~/.config/apothem/profile.yaml. |
--dry-run | Previsualiza la actualización sin escribir archivos. |
--project PATH | Raíz del proyecto para los entornos con alcance de proyecto. Es obligatoria cuando el conjunto de entornos seleccionado incluye adaptadores de alcance de proyecto. |
--quiet, -q | Suprime la salida informativa; solo se emiten errores. |
--verbose, -v | Emite salida de diagnóstico adicional. |
--format plain|json | Formato de salida (predeterminado: plain). |
--json | Abreviatura de --format json. |
--no-color | Desactiva los códigos de color ANSI en la salida. |
-h, --help | Muestra la ayuda y sale. |
Salida JSON
{
"schema_version": 1,
"status": "success",
"command": "update",
"action": "updated",
"harness": "claude-code",
"profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
"project": null,
"files_written": [],
"results": [],
"warnings": [],
"error": null,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}--dry-run devuelve status: "dry_run" y files_written: [].
Ejemplos
apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem update --harness all --project . --dry-run --json
apothem Updating --harness claude-code # continuous-form alias
apothem updating --harness claude-code # lowercase variantCódigos de salida
| Código | Significado |
|---|---|
| 0 | Adaptador actualizado correctamente o ejecución en seco planificada sin problemas |
| 1 | Error previsto de validación, de perfil, de entorno, de proyecto o de adaptador |
| 2 | Materialización parcial del lote después de al menos una escritura |
| 64 | Error de uso: una opción o un comando desconocidos, o un valor de opción ausente o no válido. Con --json, el error es un sobre JSON con el código cli.usage. |
Véase también
apothem updating— alias en forma continua de este comando (documentado aquí; la CLI acepta ambas formas)- apothem install — instalación inicial
- Guía de actualización — rutas de actualización por instalador