<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/how-to/harnesses/codex/">
  <id>https://docs.spec-kitty.ai/guides/how-to/harnesses/codex/</id>
  <title>Use Spec Kitty in Codex CLI</title>
  <updated>2026-10-21T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/how-to/harnesses/codex/"/>
  <summary>How to use Spec Kitty in Codex CLI, the first-class harness with the heaviest agent skills integration: prerequisites, skill install, and the command workflow.</summary>
  <content type="html">&lt;span id=&quot;use-spec-kitty-in-codex-cli&quot;&gt;&lt;/span&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Tier:&lt;/strong&gt; first_class — heaviest agent skills integration.
&lt;strong&gt;Citation (accessed 2026-05-21):&lt;/strong&gt; &lt;a href=&quot;https://github.com/openai/codex&quot;&gt;https://github.com/openai/codex&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Spec Kitty CLI installed.&lt;/strong&gt; See &lt;a href=&quot;/guides/how-to/installation/install-spec-kitty/&quot;&gt;Install Spec Kitty&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project initialized for this harness:&lt;/strong&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;init&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--ai&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;codex&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Codex CLI installed and authenticated.&lt;/strong&gt; Follow the &lt;a href=&quot;https://github.com/openai/codex&quot;&gt;openai/codex README&lt;/a&gt; for installation and login.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;where-spec-kitty-installs-files&quot;&gt;Where Spec Kitty installs files&lt;/h2&gt;
&lt;p&gt;Per the &lt;a href=&quot;/api/supported-harnesses/&quot;&gt;supported-harnesses matrix&lt;/a&gt;, Codex CLI consumes Spec Kitty as &lt;strong&gt;agent skills&lt;/strong&gt; (not slash commands). Spec Kitty installs:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Directory:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;.agents/skills/spec-kitty-&amp;#x3C;command&gt;/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Files:&lt;/strong&gt; one &lt;code dir=&quot;auto&quot;&gt;SKILL.md&lt;/code&gt; per command (&lt;code dir=&quot;auto&quot;&gt;spec-kitty-specify/SKILL.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-plan/SKILL.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-tasks/SKILL.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-implement/SKILL.md&lt;/code&gt;, etc.).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Manifest:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;.kittify/command-skills-manifest.json&lt;/code&gt; records which agents reference each skill package.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Codex reads the skill tree directly; the same tree is shared with Mistral Vibe via &lt;code dir=&quot;auto&quot;&gt;.vibe/config.toml&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;skill_paths&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Before the 4.0.0rc8 release these folders were named &lt;code dir=&quot;auto&quot;&gt;spec-kitty.&amp;#x3C;command&gt;&lt;/code&gt;. The Agent Skills specification does not allow a dot in a skill name, so &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; renames them; see &lt;a href=&quot;/migrations/command-skill-hyphen-names/&quot;&gt;Command skills renamed for the Agent Skills specification&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;canonical-invocation&quot;&gt;Canonical invocation&lt;/h2&gt;
&lt;p&gt;Inside the Codex CLI, skills are invoked with the &lt;code dir=&quot;auto&quot;&gt;$&lt;/code&gt; prefix:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;$spec-kitty-specify &quot;&amp;#x3C;one-line mission description&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;$spec-kitty-plan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;$spec-kitty-tasks&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;$spec-kitty-implement WP01&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;This is the key difference from slash-command hosts — do not type &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.*&lt;/code&gt; in Codex; use &lt;code dir=&quot;auto&quot;&gt;$spec-kitty-*&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;worked-example&quot;&gt;Worked example&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;From your project root, start Codex (&lt;code dir=&quot;auto&quot;&gt;codex&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;At the prompt, type:
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;$spec-kitty-specify &quot;a hello world page&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;Spec Kitty’s interview prompts appear — answer them inline.&lt;/li&gt;
&lt;li&gt;When asked for a kebab-case slug, supply something short, e.g. &lt;code dir=&quot;auto&quot;&gt;hello-world-page&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The mission spec lands at &lt;code dir=&quot;auto&quot;&gt;kitty-specs/hello-world-page-&amp;#x3C;mid8&gt;/spec.md&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;$spec-kitty-*&lt;/code&gt; skills do not appear.&lt;/strong&gt;
Run &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent config sync&lt;/code&gt; from the repo root. This regenerates &lt;code dir=&quot;auto&quot;&gt;.agents/skills/spec-kitty-*/SKILL.md&lt;/code&gt; from the canonical source templates and re-registers the manifest. Restart Codex.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Profile not loading (researcher / reviewer roles do not adopt).&lt;/strong&gt;
At the Codex prompt, run:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spk-charter-profile-load researcher-robbie&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Use the profile id named in the work-package frontmatter (&lt;code dir=&quot;auto&quot;&gt;agent_profile:&lt;/code&gt;).&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;where-to-learn-more-about-codex&quot;&gt;Where to learn more about Codex&lt;/h2&gt;
&lt;p&gt;Authoritative documentation: &lt;a href=&quot;https://github.com/openai/codex&quot;&gt;https://github.com/openai/codex&lt;/a&gt; (accessed 2026-05-21). Consult the repository README for the latest agent skills syntax and version notes.&lt;/p&gt;</content>
</entry>
