Aller au contenu
Documentation : Codex

Codex

Où rmk place chaque type d'élément pour Codex, et ce que Codex vous demande d'abord.

La documentation fournie avec Ronne AI Marketplace 0.3.0, traduite de l'anglais.

Où va chaque type

Avec --target codex, rmk écrit chaque élément là où Codex le lit : dans le projet, ou dans votre dossier personnel avec --scope user.

TypeOù il va
skill.agents/skills/<name>/ (votre dossier personnel : ~/.agents/skills/)
agent.codex/agents/<name>.toml
ruleune section dans AGENTS.md (votre dossier personnel : ~/.codex/AGENTS.md), ou un skill quand l'IA le décide ou que vous le demandez
command.agents/skills/<name>/, lancée avec /<name>
hookhooks dans .codex/hooks.json; un script sous .codex/hooks/<name>/
mcp-servermcp_servers dans .codex/config.toml
permission-policy.codex/rules/<name>.rules, pour les commandes shell seulement
output-stylenon pris en charge : ignoré avec un avertissement
statuslinenon pris en charge : ignoré avec un avertissement
lsp-servernon pris en charge : ignoré avec un avertissement
bundlerien en propre : ses éléments sont installés un par un

rmk export --from codex lit aux mêmes endroits les agents et les serveurs MCP que vous avez écrits pour Codex : Exporter vos propres éléments.

Confiance et revue des hooks

Codex ne lit le .codex/config.toml, les hooks et les règles d'un projet qu'une fois que vous faites confiance au projet, et n'exécute les hooks nouveaux ou modifiés qu'après que vous les avez revus avec /hooks. rmk vous le rappelle après une installation qui demande l'un ou l'autre.

Bon à savoir

  • Les skills et les commandes vont dans .agents/skills/, le dossier que Cursor lit aussi, donc une seule copie sert aux deux. Les commandes deviennent des skills que vous lancez avec /name; Codex ne leur passe pas d'arguments, alors une note dans le skill indique ce qu'est chaque paramètre fictif.
  • Les règles sont des sections d'AGENTS.md entre les marqueurs rmk:begin et rmk:end, et votre propre texte autour n'est jamais touché. Codex lit au plus 32 Kio d'instructions, et rmk vous avertit quand AGENTS.md dépasse cette taille.
  • Les serveurs MCP obtiennent leurs secrets par le nom de la variable (env_vars, bearer_token_env_var) : rien de secret n'est écrit, et vous définissez les variables vous-même.
  • rmk réécrit config.toml dans une seule mise en forme quand il ajoute ou retire un serveur, donc les commentaires qu'il contient ne sont pas conservés. Il le signale la première fois.
  • Les agents Codex n'ont ni liste d'outils ni modèle rapide ou puissant : un agent reçoit les outils et le modèle de la session, à moins que son élément ne définisse un modèle Codex. Les hooks s'exécutent pour tous les outils, puisque les noms d'outils de Codex ne sont pas documentés; un hook destiné à un seul outil lit l'événement sur stdin et vérifie.
  • Les politiques de permissions deviennent des règles Codex pour les commandes shell seulement, que Codex marque comme expérimentales. Les styles de sortie, les lignes d'état et les serveurs de langage n'ont pas de place dans Codex, et sont ignorés avec un avertissement.

Plugins

Codex peut aussi installer les éléments de ce marketplace sous forme de plugins, à partir d'un dépôt git que rmk feed build tient à jour comme miroir. Les plugins Codex contiennent des skills, des serveurs MCP et des hooks, pas des agents. Marketplaces de plugins explique comment.