altis-codex-harness

Harness Codex da Altis Sistemas: skills, agentes customizados, prompts, hooks, MCPs altis-rag e altis-docsai, status line, plugin local e liberacao por estacao, instalados via npx.

Instalar

Pre-requisitos: Node.js 18+, Python 3 no PATH e estacao liberada pelo gestor.

npx altis-codex-harness install

O instalador usa, por padrao:

• ~/.codex: AGENTS.md, config.toml, hooks.json, hooks, prompts, agentes TOML e copia de compatibilidade das skills.
• ~/.agents/skills: skills pessoais descobertas pelo Codex.
• ~/plugins/altis-codex-harness: plugin local com as mesmas skills.
• ~/.agents/plugins/marketplace.json: entrada do marketplace pessoal.

Se a estacao nao estiver liberada, o comando mostra os MACs da maquina para envio ao gestor.

Comandos

npx altis-codex-harness status
npx altis-codex-harness check
npx altis-codex-harness update
npx altis-codex-harness uninstall

Flags uteis para teste ou instalacao customizada:

npx altis-codex-harness install --target C:\tmp\.codex --agents-home C:\tmp\.agents --plugin-root C:\tmp\plugins\altis-codex-harness
npx altis-codex-harness install --skip-plugin
npx altis-codex-harness install --skip-global-instructions

O que e instalado

• Skills geradas de payload/skills, payload/agents, payload/rules e payload/commands.
• Agentes customizados Codex em TOML gerados de payload/agents.
• Prompts globais em ~/.codex/prompts para os playbooks Altis.
• Hooks Codex em ~/.codex/hooks.json apontando para ~/.codex/hooks/altis.
• MCPs altis-rag e altis-docsai em bloco gerenciado de ~/.codex/config.toml.
• Status line nativa do Codex com projeto, branch, modelo, contexto, tokens e limites de uso. Uma tui.status_line pessoal preexistente e preservada.
• Plugin local altis-codex-harness publicado no marketplace pessoal.

Arquivos pessoais sao preservados. O que o instalador gerencia fica registrado em ~/.codex/altis-codex.manifest.json; arquivos modificados localmente sao restaurados no proximo update, com aviso.

Auto-update

O hook SessionStart executa uma checagem em background no maximo a cada 4 horas. Quando houver versao nova no npm, ele roda:

npx -y altis-codex-harness@latest update

Log do auto-update: ~/.codex/hooks/altis/update.log.

No mesmo SessionStart, legacy_cleanup.cjs remove apenas hooks Altis antigos de <repo>/.codex/hooks.json, preservando hooks pessoais e criando backup unico antes de qualquer correcao.

Liberacao de estacoes

1. O dev roda npx altis-codex-harness status e envia os MACs exibidos.
2. O gestor adiciona a entrada em payload/hooks/liberacoes.json.
3. Publique nova versao no npm para propagar a liberacao.

Para revogar, remova a entrada e publique nova versao. A liberacao tambem exige contato com o registry nas ultimas 24h.

Desenvolvimento

npm test
node scripts/validate-payload.js
npm pack --dry-run

Estrutura principal:

• bin/cli.js: CLI install|update|check|status|uninstall.
• lib/: conversao Codex, sync multi-alvo, hooks, MCP TOML, marketplace e manifest.
• payload/: conteudo Altis distribuido.
• test/: testes node --test.

O conteudo funcional de payload/agents, payload/commands, payload/rules e payload/skills deve acompanhar o altis-claude-harness. Integracoes de plataforma sao adaptadas para as superficies nativas do Codex, sem copiar configuracoes Claude que o Codex nao interpreta.