odd-studio 3.3.0 → 3.3.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "odd-studio",
   "description": "Outcome-Driven Development — a planning and build harness for domain experts building serious software with AI. Installs the /odd skill, safety hooks, and project scaffolding into Claude Code.",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "author": {
     "name": "ODD Studio"
   },

package/README.md

@@ -45,6 +45,9 @@ npx odd-studio init my-project --agent codex
 cd my-project
 ```
 
+In Codex, ODD Studio is installed as a project-local plugin with visible plugin commands. After restarting Codex, type `/odd`.
+Once inside `/odd`, the same starred flow works there too, including commands like `*plan`, `*build`, and `*status`. You can also invoke the direct Codex commands such as `/odd-build`.
+
 ### For Claude Code and OpenCode on the same machine
 
 ```bash
@@ -154,6 +157,7 @@ ODD Studio installs safety gates that run automatically throughout your build. T
 **Claude Code:** Implemented as shell hooks registered in `.claude/settings.local.json` (project-local).
 **OpenCode:** Implemented as a JS plugin (`odd-studio-plugin.js`) in `.opencode/plugins/` (project-local).
 **Codex:** Implemented as a project-local plugin in `plugins/odd-studio/` with `hooks.json` and plugin-local skills.
+It also installs Codex plugin commands so `/odd` is directly discoverable in the composer.
 
 ---
 
@@ -238,6 +242,7 @@ my-project/
 ├── .agents/plugins/marketplace.json ← Codex local marketplace registration
 ├── plugins/odd-studio/              ← Codex project-local plugin
 │   ├── .codex-plugin/plugin.json    ← Codex plugin manifest
+│   ├── commands/odd.md              ← Codex /odd command entrypoint
 │   ├── skills/                      ← ODD Studio skills for Codex
 │   ├── hooks/odd-studio.sh          ← Safety gate hook script
 │   ├── hooks.json                   ← Codex hook registration

package/bin/odd-studio.js

@@ -15,7 +15,7 @@ import { registerUninstall } from './commands/uninstall.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const require = createRequire(import.meta.url);
-const pkg = require('../package.json'); // v3.3.0
+const pkg = require('../package.json'); // v3.3.2
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const deps = { PACKAGE_ROOT, print };

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Outcome-Driven Development planning and build harness for domain experts building serious software with AI.",
   "author": {
     "name": "ODD Studio"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Outcome-Driven Development for AI coding agents — a planning and build harness for domain experts building serious software with AI. Works with Claude Code, OpenCode, and Codex.",
   "keywords": [
     "claude-code",

package/scripts/install-codex-commands.js

@@ -0,0 +1,56 @@
+'use strict';
+import fs from 'fs-extra';
+import path from 'path';
+import { COMMANDS } from './command-definitions.js';
+import { CODEX_PLUGIN_NAME } from './assets.js';
+
+const CODEX_ODD_ROOT = `plugins/${CODEX_PLUGIN_NAME}/skills/odd/`;
+
+export default async function installCodexCommands(pluginDest) {
+  const commandsDest = path.join(pluginDest, 'commands');
+  await fs.ensureDir(commandsDest);
+
+  for (const cmd of COMMANDS) {
+    const content = cmd.source
+      ? buildMainCommand(cmd)
+      : buildSubcommand(cmd);
+    await fs.writeFile(path.join(commandsDest, `${cmd.name}.md`), content);
+  }
+
+  return { destination: commandsDest, commandCount: COMMANDS.length };
+}
+
+function buildMainCommand(cmd) {
+  return [
+    '---',
+    `description: "${cmd.description}"`,
+    '---',
+    '',
+    '# /odd',
+    '',
+    'You are now operating as the ODD Studio coach.',
+    '',
+    'Read this file now:',
+    `- \`${CODEX_ODD_ROOT}SKILL.md\` — the full ODD Studio coach`,
+    '',
+    'Then execute the startup state check exactly as documented.',
+    '',
+  ].join('\n');
+}
+
+function buildSubcommand(cmd) {
+  return [
+    '---',
+    `description: "${cmd.description}"`,
+    '---',
+    '',
+    `# /${cmd.name}`,
+    '',
+    rewriteBody(cmd.body),
+    '',
+  ].join('\n');
+}
+
+function rewriteBody(body) {
+  return body.replace(/`\.opencode\/odd\//g, `\`${CODEX_ODD_ROOT}`);
+}

package/scripts/setup-codex-plugin.js

@@ -6,6 +6,7 @@ import {
   CODEX_PLUGIN_NAME,
   ODD_HOOK_FILE,
 } from './assets.js';
+import installCodexCommands from './install-codex-commands.js';
 
 const PLUGIN_RELATIVE_PATH = `./plugins/${CODEX_PLUGIN_NAME}`;
 const MARKETPLACE_ENTRY = {
@@ -33,6 +34,7 @@ export default async function setupCodexPlugin(packageRoot, targetDir) {
 
   await fs.copy(pluginSource, pluginDest, { overwrite: true });
   await installCodexSkills(skillSource, pluginDest);
+  await installCodexCommands(pluginDest);
   await installCodexHook(hookSource, pluginDest);
   const marketplaceUpdated = await updateMarketplace(targetDir);
 

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "odd"
-version: "3.3.0"
+version: "3.3.2"
 description: "Outcome-Driven Development planning and build coach. Use /odd to start or resume an ODD project — building personas, writing outcomes, mapping contracts, creating a Master Implementation Plan, and directing a odd-flow-powered build. Designed for domain experts who are not developers. Works with Claude Code, OpenCode, and Codex."
 ---
 
@@ -35,7 +35,7 @@ Display this when no existing state is found:
 
 ---
 
-Welcome to ODD Studio v3.3.0.
+Welcome to ODD Studio v3.3.2.
 
 You are about to plan and build something real — using a methodology called Outcome-Driven Development. Before we write a single line of code, we are going to get precise about three things:
 
@@ -59,7 +59,7 @@ Display this when existing state is found. Replace the bracketed values with act
 
 ---
 
-Welcome back to ODD Studio v3.3.0.
+Welcome back to ODD Studio v3.3.2.
 
 **Project:** [project.name]
 **Current Phase:** [state.currentPhase]