Apothem versus a configuração manual do Codex
Manter à mão o AGENTS.md, os hooks, as skills e os agentes do Codex versus instalá-los a partir do perfil compartilhado do Apothem.
O Codex lê as instruções do usuário do AGENTS.md, carrega hooks de hooks.json
ou config.toml, descobre agentes personalizados em agents/ e descobre skills
a partir da raiz compartilhada de skills do Codex. O adaptador codex do Apothem
instala essas superfícies a partir do perfil compartilhado, deixando intactos os
ajustes de config.toml que pertencem ao operador.
Comparação de esforço
| Tarefa | Configuração manual | Gerenciada pelo Apothem |
|---|---|---|
Escrever AGENTS.md | Editar à mão as instruções do usuário | Instalado a partir do modelo de bootstrap do Codex |
| Escrever hooks | Escrever à mão hooks.json ou tabelas de hook TOML | Instalado em ~/.codex/hooks.json com os auxiliares de hook do Apothem em ~/.codex/hooks/ |
| Escrever agentes personalizados | Escrever à mão arquivos TOML em ~/.codex/agents/ | Convertidos dos agentes Markdown do Apothem |
| Escrever comandos reutilizáveis | Construir skills à mão, um diretório por vez | Empacotados como ~/.agents/skills/*/SKILL.md |
| Manter as regras alinhadas com outros ambientes | Manual, por ferramenta | Automático no apothem update |
| Verificar se a configuração está correta | Inspeção manual | apothem verify --harness codex |
O que o Apothem gerencia
O adaptador codex instala AGENTS.md, hooks.json, os arquivos auxiliares de
hook, os agentes personalizados convertidos e as skills geradas. Ele não
sobrescreve ~/.codex/config.toml; o modelo, o sandbox, a aprovação, o MCP e
outras preferências de tempo de execução continuam pertencendo ao operador.
Caminho de migração
- Execute
apothem profile initpara criar o perfil compartilhado se você ainda não tiver. - Mova as regras do seu
AGENTS.mdexistente para o corpus compartilhado. - Mantenha os ajustes de tempo de execução do
config.tomlexistente no Codex, a menos que você escolha gerenciá-los à mão em outro lugar. - Execute
apothem install --harness codexpara instalar as superfícies nativas do Codex. - Execute
apothem verify --harness codexpara confirmar que os arquivos foram instalados. - Use
apothem update --harness codexpara cada mudança posterior.
Leia a seguir
Apothem vs. configuração bruta do GitHub Copilot
Manter à mão o copilot-instructions.md do GitHub Copilot versus renderizá-lo a partir do perfil compartilhado do Apothem.
Apothem vs. configuração bruta do Windsurf
Manter à mão as regras do Windsurf em .devin/rules/ versus renderizá-las a partir do perfil compartilhado do apothem.