Editar o perfil

Objetivo: alterar um valor no perfil compartilhado e propagá-lo para todos os harnesses que você tem instalados.

Pré-requisitosCopy Anchor Link

• A CLI apothem no seu PATH (ou a forma autocontida: prefixe com PYTHONPATH="$HOME/.apothem/src" e execute python -m apothem, ou use npx @ahmed-g-gad/apothem).
• Um perfil em ~/.config/apothem/profile.yaml. Crie um com apothem profile init se ele estiver ausente.

A forma do perfilCopy Anchor Link

O perfil é um único documento YAML. Suas chaves de nível superior:

• identity (obrigatório) — name, mais os opcionais role, email, website, github.
• preferences — language, style (concise / verbose / balanced), formatter, test_framework.
• rules — uma lista de strings de regras adicionais compartilhadas com harnesses capazes.
• seriousness — um de EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH.
• enforcement — alternadores opcionais (sprints, agent_teams, multitasking, continuous_execution, learning_loop), cada flag desligada por padrão.
• harnesses — sobrescritas por harness indexadas pelo id do harness.
• exclude_harnesses — ids de harnesses ignorados por comandos em lote (--harness all).
• mcp_servers — definições de servidores MCP indexadas pelo nome do servidor.
• agent_mcp_servers — por nome de auxiliar, os servidores MCP que esse auxiliar pode chamar (veja Dar a um auxiliar acesso a servidores MCP). Vazio por padrão, então nenhum auxiliar alcança uma ferramenta MCP.
• workspace — onde o Apothem mantém seu diretório de trabalho compartilhado (directory_name, scope).
• schema_version — versão opcional do esquema do perfil; um perfil sem ela é lido como versão 1.

Todos os campos estão listados em Campos do perfil.

PassosCopy Anchor Link

1. Inspecione o perfil atual:

   Copy Text

   apothem profile show

2. Edite-o. Abra-o no editor do seu sistema:

   Copy Text

   apothem profile edit

   Ou defina uma única chave pontilhada a partir da linha de comando. O valor é armazenado literalmente (com exceção de true/false e entradas explícitas [..]/{..}, que são interpretadas) e o perfil é validado contra o esquema antes da gravação — uma definição inválida é recusada e o perfil em disco permanece inalterado:

   Copy Text

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

3. Rematerialize os harness para que a alteração chegue à configuração nativa deles. Para um harness de escopo de usuário:

   Copy Text

   apothem update --harness claude-code

   Para um harness de escopo de projeto, informe a raiz do projeto; use all para atualizar todos os harness instalados:

   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 reflete a sua edição.

apothem verify --harness all verifica todos os harnesses registrados, exceto os listados em exclude_harnesses do perfil; por isso ele sai com código diferente de zero, a menos que todos os demais estejam instalados. Harnesses de escopo de projeto também exigem --project PATH; sem ele, o lote para com um erro project.required. Para verificar apenas o harness que você atualizou, execute o mesmo comando com o nome desse harness:

apothem verify --harness <name>

Para uma visão do sistema inteiro que tolera harnesses que você não instalou, execute apothem doctor.

RelacionadoCopy Anchor Link

• Adicionar um harness para colocar um novo harness sob o controle do perfil antes de rematerializar.
• Atualização cobre a atualização do mecanismo junto com a etapa de rematerialização.