Editar el perfil

Objetivo: cambiar un valor en el perfil compartido e impulsarlo a cada entorno que tengas instalado.

Requisitos previosCopy Anchor Link

• La CLI apothem en tu PATH (o la forma autocontenida: antepone PYTHONPATH="$HOME/.apothem/src" y ejecuta python -m apothem, o usa npx @ahmed-g-gad/apothem).
• Un perfil en ~/.config/apothem/profile.yaml. Crea uno con apothem profile init si falta.

La forma del perfilCopy Anchor Link

El perfil es un único documento YAML. Sus claves de nivel superior:

• identity (obligatorio) — name, más role, email, website, github opcionales.
• preferences — language, style (concise / verbose / balanced), formatter, test_framework.
• rules — una lista de cadenas de reglas adicionales compartidas con los entornos capaces.
• seriousness — uno de EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH.
• enforcement — interruptores opcionales (sprints, agent_teams, multitasking, continuous_execution, learning_loop), cada indicador desactivado por defecto.
• harnesses — anulaciones por entorno indexadas por id de entorno.
• exclude_harnesses — ids de entorno omitidos por los comandos en lote (--harness all).
• mcp_servers — definiciones de servidores MCP indexadas por nombre de servidor.
• agent_mcp_servers — por nombre de trabajador delegado, los servidores MCP a los que ese trabajador puede llamar (consulta Dar a un trabajador delegado acceso a servidores MCP). Vacío por defecto, así que ningún trabajador delegado llega a una herramienta MCP.
• workspace — dónde guarda Apothem su directorio de trabajo compartido (directory_name, scope).
• schema_version — versión opcional del esquema del perfil; un perfil sin ella se lee como versión 1.

Todos los campos se enumeran en Campos del perfil.

PasosCopy Anchor Link

1. Inspecciona el perfil actual:

   Copy Text

   apothem profile show

2. Edítalo. Ábrelo en el editor de tu sistema:

   Copy Text

   apothem profile edit

   O establece una única clave con notación de puntos desde la línea de comandos. El valor se almacena literalmente (excepto la entrada true/false y la explícita [..]/{..}, que sí se parsean) y el perfil se valida contra el esquema antes de escribirse — una asignación inválida se rechaza y el perfil en disco queda sin cambios:

   Copy Text

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. Vuelve a materializar los entornos para que el cambio llegue a su configuración nativa. Para un entorno de ámbito de usuario:

   Copy Text

   apothem update --harness claude-code

   Para un entorno de ámbito de proyecto, pasa la raíz del proyecto; usa all para refrescar cada entorno instalado:

   Copy Text

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

VerificarCopy Anchor Link

apothem profile show
apothem verify --harness all

profile show refleja tu edición.

apothem verify --harness all comprueba todos los entornos registrados excepto los que enumera exclude_harnesses del perfil, así que termina con un código distinto de cero salvo que todos los demás estén instalados. Los entornos de alcance de proyecto también necesitan --project PATH; sin él, el lote se detiene con un error project.required. Para comprobar solo el entorno que actualizaste, ejecuta el mismo comando con el nombre de ese entorno:

apothem verify --harness <name>

Para una vista de todo el sistema que tolera los entornos que no has instalado, ejecuta apothem doctor.

RelacionadoCopy Anchor Link

• Añadir un entorno para poner un nuevo entorno bajo el control del perfil antes de volver a materializar.
• Actualización cubre la actualización del motor junto con el paso de re-materialización.