Pular para o conteúdo
Documentação: Codex

Codex

Onde o rmk coloca cada tipo de item para o Codex, e o que o Codex pede de você antes.

A documentação que vem no Ronne AI Marketplace 0.3.0, traduzida do inglês.

Onde fica cada tipo

Com --target codex, o rmk grava cada item onde o Codex o lê: no projeto, ou na sua pasta pessoal com --scope user.

TipoOnde fica
skill.agents/skills/<name>/ (na sua pasta pessoal: ~/.agents/skills/)
agent.codex/agents/<name>.toml
ruleuma seção no AGENTS.md (na sua pasta pessoal: ~/.codex/AGENTS.md), ou uma skill quando a IA decidir ou você pedir
command.agents/skills/<name>/, executado como /<name>
hookhooks em .codex/hooks.json; um script em .codex/hooks/<name>/
mcp-servermcp_servers em .codex/config.toml
permission-policy.codex/rules/<name>.rules, só para comandos de shell
output-stylesem suporte: ignorado com um aviso
statuslinesem suporte: ignorado com um aviso
lsp-serversem suporte: ignorado com um aviso
bundlenada próprio: os itens dele são instalados um por um

O rmk export --from codex lê dos mesmos lugares os agentes e os servidores MCP que você escreveu para o Codex: Exportar os seus próprios itens.

Confiança e revisão de hooks

O Codex só lê o .codex/config.toml, os hooks e as regras de um projeto depois que você confia no projeto, e só roda hooks novos ou alterados depois que você os revisa com /hooks. O rmk lembra você depois de uma instalação que precise de um dos dois.

Bom saber

  • Skills e comandos vão para .agents/skills/, a pasta que o Cursor também lê, então uma cópia serve para os dois. Comandos viram skills que você roda como /name; o Codex não passa argumentos para eles, então uma nota na skill diz o que é cada placeholder.
  • Regras são seções do AGENTS.md entre os marcadores rmk:begin e rmk:end, e o seu próprio texto em volta delas nunca é alterado. O Codex lê no máximo 32 KiB de instruções, e o rmk avisa quando o AGENTS.md passa disso.
  • Servidores MCP recebem os seus segredos pelo nome da variável (env_vars, bearer_token_env_var): nada secreto é gravado, e você mesmo define as variáveis.
  • O rmk regrava o config.toml em um único formato quando adiciona ou remove um servidor, então os comentários nele não são mantidos. Ele avisa isso na primeira vez.
  • Agentes do Codex não têm lista de ferramentas nem modelo rápido ou forte: um agente recebe as ferramentas e o modelo da sessão, a menos que o item dele defina um modelo do Codex. Hooks rodam para todas as ferramentas, já que os nomes das ferramentas do Codex não são documentados; um hook feito para uma só ferramenta lê o evento no stdin e confere.
  • Políticas de permissões viram regras do Codex só para comandos de shell, que o Codex marca como experimentais. Estilos de saída, linhas de status e servidores de linguagem não têm lugar no Codex e são ignorados com um aviso.

Plugins

O Codex também pode instalar os itens deste marketplace como plugins, a partir de um repositório git que o rmk feed build mantém como espelho dele. Plugins do Codex trazem skills, servidores MCP e hooks, não agentes. Marketplaces de plugins explica como.