Adicionar um harness

Objetivo: habilitar mais um harness para que o Apothem materialize a configuração nativa desse harness a partir do seu perfil compartilhado.

Pré-requisitosCopy Anchor Link

• Um perfil compartilhado em ~/.config/apothem/profile.yaml (crie um com apothem profile init se ele ainda não existir).
• A CLI apothem no seu PATH. Se você instalou a árvore de fontes autocontida, prefixe cada comando com PYTHONPATH="$HOME/.apothem/src" e execute python -m apothem no lugar de apothem — ou use npx @ahmed-g-gad/apothem.

PassosCopy Anchor Link

1. Liste os harnesses registrados e veja quais já estão instalados:

   Copy Text

   apothem harnesses list

   apothem harnesses list imprime cada id suportado; o mesmo conjunto está na lista de harnesses e no registro de harnesses gerado a partir do código-fonte. Escolha o id da sua ferramenta em vez de fixar a lista aqui — ela cresce conforme adaptadores são adicionados.

2. Inspecione o harness-alvo para confirmar seu escopo e caminho de saída:

   Copy Text

   apothem harnesses show cursor

   Uma linha Scope: project significa que o adaptador materializa em uma árvore de projeto e requer --project PATH; Scope: user materializa em um diretório de configuração de escopo de usuário e não precisa de flag de projeto.

3. Pré-visualize a instalação sem gravar arquivos:

   Copy Text

   apothem install --harness cursor --project /path/to/project --dry-run

4. Instale o harness. Para um harness de escopo de usuário:

   Copy Text

   apothem install --harness claude-code

   Para um harness de escopo de projeto, informe a raiz do projeto:

   Copy Text

   apothem install --harness cursor --project /path/to/project

   Instale todos os harnesses suportados de uma vez com --harness all (harnesses de escopo de projeto ainda precisam de --project; ids listados em exclude_harnesses no perfil são ignorados).

VerificarCopy Anchor Link

apothem verify --harness cursor --project /path/to/project

Uma linha ✓ <harness-id> is verified confirma que os alvos gerenciados existem e são interpretáveis. apothem doctor fornece a visão do sistema inteiro em todos os harnesses.

RelacionadoCopy Anchor Link

• Editar o perfil para alterar o que o adaptador materializa, e então reexecute apothem update.
• Instalação cobre a instalação inicial.