Adaptadores de harness

O Apothem traz dezessete adaptadores de harness integrados. Cada adaptador traduz os mesmos cohorts compartilhados em arquivos nativos da plataforma onde a plataforma os suporta e em árvores de suporte de propriedade do Apothem onde ela não suporta.

Harnesses suportadosCopy Anchor Link

O registro de suportados contém exatamente dezessete adaptadores. Use estes nomes exatos de instalação com --harness, ou use all para o conjunto determinístico do registro:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

A matriz detalhada do registro, os caminhos de destino, os estados de capacidade, o suporte a MCP e as evidências de convention-pin ficam na referência técnica do registro.

Instalar vários harnessesCopy Anchor Link

Instale um harness, ou use all para selecionar o registro em ordem determinística. Harnesses com escopo de projeto exigem --project PATH; isso inclui all porque o registro inclui tanto alvos com escopo de usuário quanto com escopo de projeto.

apothem install --harness claude-code
apothem install --harness cursor --project /path/to/project
apothem install --harness gemini-cli --project /path/to/project
apothem install --harness all --project /path/to/project

Verificar suas instalaçõesCopy Anchor Link

Verifique cada adaptador de harness individualmente, ou chame apothem doctor para um resumo de status de instalação por adaptador em todos os adaptadores registrados:

apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctor

Como os adaptadores funcionamCopy Anchor Link

Cada adaptador implementa o protocolo HarnessAdapter registrado via entry-points do setuptools. Na instalação, a CLI carrega e valida o perfil YAML compartilhado, resolve o adaptador através do registro, valida o plano de materialização e grava a configuração nativa da plataforma na localização nativa de usuário ou de projeto da ferramenta. Na atualização, ela rederiva a partir do estado atual do perfil.

profile.yaml + packaged cohorts
    identity / preferences / rules
    commands / skills / delegated definitions / hooks / templates
         |
         +-- antigravity    --> ~/.gemini/GEMINI.md + ~/.gemini/antigravity-cli/plugins/apothem/
         +-- claude-code    --> ~/.claude/ native folders + ~/.claude/.apothem/support/
         +-- codex          --> ~/.codex/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- cursor         --> <project>/.cursor/rules/*.mdc + <project>/.cursor/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- gemini-cli     --> <project>/GEMINI.md + <project>/.gemini/
         +-- github-copilot --> <project>/.github/copilot-instructions.md + <project>/.github/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- windsurf       --> <project>/.devin/rules/ + <project>/.devin/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- ...

Skills no seu diretório pessoalCopy Anchor Link

Sete adaptadores com escopo de projeto gravam um arquivo de regras no seu projeto (seis deles também gravam ali os auxiliares do Apothem como arquivos de subagente; cada página de harness nomeia a pasta), e também gravam as skills do Apothem, e as regras e templates que as skills citam, em pastas no seu diretório pessoal:

cursor, github-copilot, windsurf, zed  ->  ~/.agents/skills/ (codex writes it too)
codebuddy                               ->  ~/.codebuddy/skills/
kiro                                    ->  ~/.kiro/skills/
trae                                    ->  ~/.trae/skills/
all seven                               ->  ~/.config/apothem/rules/ and templates/ (codex uses them too)

• Toda instalação que nomeia uma pasta grava os mesmos arquivos, então a ordem em que você instala não importa, e uma única cópia serve a todos os projetos.
• Uma instalação grava as pastas do diretório pessoal primeiro. Se isso falhar, ela para antes de alterar o projeto, e não adiciona nenhum arquivo de skill ou de regra ao seu repositório.
• Uma desinstalação remove uma pasta compartilhada somente quando nenhuma outra instalação do Apothem ainda a usa, e diz qual instalação a mantém.
• Uma pasta de skill com o nome de uma skill do Apothem que o Apothem não gravou é deixada intacta, com um aviso.

Cada página de harness lista as suas pastas. O registro de harnesses mostra quais ferramentas compartilham qual pasta.

Consulte Abstração de adaptador de harness para a especificação do protocolo.