@undeemed/get-shit-done-codex 1.22.1 → 1.23.1

package/README.md

@@ -5,8 +5,9 @@ A meta-prompting, context engineering and spec-driven development system for [Op
 Fork of [get-shit-done](https://github.com/taches/get-shit-done) by TÂCHES, adapted for Codex CLI by [undeemed](https://github.com/undeemed).
 
 > [!CAUTION]
-> As of February 25, 2026, Codex is supported upstream. This fork remains focused on Codex-specific UX and compatibility with extra goodies.
+> Codex is now supported upstream. This fork remains focused on Codex-specific UX, compatibility, and experimental features for personal use.
 
+[![CI](https://github.com/undeemed/get-shit-done-codex/actions/workflows/ci.yml/badge.svg)](https://github.com/undeemed/get-shit-done-codex/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/%40undeemed%2Fget-shit-done-codex?style=flat-square)](https://www.npmjs.com/package/@undeemed/get-shit-done-codex)
 [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
 ![npm Downloads](https://img.shields.io/npm/dt/@undeemed/get-shit-done-codex?style=flat-square)
@@ -46,6 +47,7 @@ npx @undeemed/get-shit-done-codex --global
 ```bash
 npx @undeemed/get-shit-done-codex --global   # Install to ~/.codex/
 npx @undeemed/get-shit-done-codex --local    # Install to current directory
+npx @undeemed/get-shit-done-codex --path .   # Install to a specific directory
 npx @undeemed/get-shit-done-codex --global --migrate             # Clean up legacy prompts/
 npx @undeemed/get-shit-done-codex --verify --global              # Check install integrity
 npx @undeemed/get-shit-done-codex --verify --repair --global     # Auto-repair

package/bin/install.js

@@ -41,6 +41,8 @@ const hasRepair = args.includes('--repair');
 const hasNoVersionCheck = args.includes('--no-version-check') || process.env.GSD_SKIP_VERSION_CHECK === '1';
 const hasMigrate = args.includes('--migrate');
 const hasSkipMigrate = args.includes('--skip-migrate') || args.includes('--no-migrate');
+const pathIdx = args.indexOf('--path');
+const customPath = pathIdx !== -1 && args[pathIdx + 1] ? args[pathIdx + 1] : null;
 const isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
 const codexMode = 'skills';
 
@@ -52,6 +54,7 @@ if (hasHelp) {
   ${yellow}Options:${reset}
     ${cyan}-g, --global${reset}              Install globally (to ~/.codex/)
     ${cyan}-l, --local${reset}               Install locally (to current directory)
+    ${cyan}--path <dir>${reset}              Install into a specific directory
     ${cyan}--migrate${reset}                 Apply detected legacy surface cleanup without prompting
     ${cyan}--skip-migrate${reset}            Keep legacy surface files when migration is detected
     ${cyan}--verify${reset}                  Verify current install integrity
@@ -66,6 +69,9 @@ if (hasHelp) {
     ${dim}# Install to current project only${reset}
     npx ${NPM_PACKAGE} --local
 
+    ${dim}# Install to a specific directory${reset}
+    npx ${NPM_PACKAGE} --path /path/to/project
+
     ${dim}# Verify global installation${reset}
     npx ${NPM_PACKAGE} --verify --global
 
@@ -103,7 +109,7 @@ function applyReplacements(content, pathPrefix) {
   content = content.replace(/Codex CLI/g, 'Codex CLI');
   content = content.replace(/Codex/g, 'Codex');
 
-  content = content.replace(/\/gsd:/g, '/prompts:gsd-');
+  content = content.replace(/\/gsd:([a-z0-9-]*)/gi, (_, cmd) => `$gsd-${cmd.toLowerCase()}`);
 
   // Keep update workflows pointed to this fork's npm package/repo.
   content = content.replace(new RegExp(UPSTREAM_PACKAGE, 'g'), NPM_PACKAGE);
@@ -357,13 +363,24 @@ function showCachedVersionWarning() {
   }
 }
 
-function getInstallContext(isGlobal) {
-  const codexDir = isGlobal ? path.join(os.homedir(), '.codex') : process.cwd();
-  return {
-    codexDir,
-    locationLabel: isGlobal ? '~/.codex' : '.',
-    pathPrefix: isGlobal ? '~/.codex/' : './',
-  };
+function getInstallContext(isGlobal, targetPath) {
+  let codexDir;
+  let locationLabel;
+  let pathPrefix;
+  if (targetPath) {
+    codexDir = path.resolve(targetPath);
+    locationLabel = targetPath;
+    pathPrefix = codexDir.endsWith(path.sep) ? codexDir : `${codexDir}${path.sep}`;
+  } else if (isGlobal) {
+    codexDir = path.join(os.homedir(), '.codex');
+    locationLabel = '~/.codex';
+    pathPrefix = '~/.codex/';
+  } else {
+    codexDir = process.cwd();
+    locationLabel = '.';
+    pathPrefix = './';
+  }
+  return { codexDir, locationLabel, pathPrefix };
 }
 
 function listPromptCommandFiles(promptsDir) {
@@ -388,9 +405,9 @@ function detectInstalledMode(promptCount, skillCount) {
   return 'none';
 }
 
-function verifyInstall(isGlobal) {
+function verifyInstall(isGlobal, targetPath) {
   const src = path.join(__dirname, '..');
-  const { codexDir, locationLabel } = getInstallContext(isGlobal);
+  const { codexDir, locationLabel } = getInstallContext(isGlobal, targetPath);
   const promptsDir = path.join(codexDir, 'prompts');
   const skillsDir = path.join(codexDir, 'skills');
   const workflowRoot = path.join(codexDir, 'get-shit-done');
@@ -447,9 +464,9 @@ function verifyInstall(isGlobal) {
   return { ok, detectedMode };
 }
 
-function installCore(isGlobal, migrationPlan, applyMigration, done = () => {}) {
+function installCore(isGlobal, migrationPlan, applyMigration, done = () => {}, targetPath) {
   const src = path.join(__dirname, '..');
-  const { codexDir, locationLabel, pathPrefix } = getInstallContext(isGlobal);
+  const { codexDir, locationLabel, pathPrefix } = getInstallContext(isGlobal, targetPath);
 
   console.log(`  Installing to ${cyan}${locationLabel}${reset}\n`);
   fs.mkdirSync(codexDir, { recursive: true });
@@ -495,14 +512,15 @@ function installCore(isGlobal, migrationPlan, applyMigration, done = () => {}) {
     console.log(`  ${green}✓${reset} Installed get-shit-done/ workflow files`);
     console.log(`  ${green}✓${reset} Wrote get-shit-done/VERSION (${pkg.version})`);
 
+    const displayRoot = locationLabel.endsWith('/') ? locationLabel.slice(0, -1) : locationLabel;
     console.log(`
   ${green}Done!${reset}
 
   ${yellow}For Codex (CLI + Desktop):${reset}
-  - AGENTS.md: ${cyan}${codexDir}/AGENTS.md${reset}
-  - Native skills: ${cyan}${codexDir}/skills/gsd-*/SKILL.md${reset}
-  - Config: ${cyan}${codexDir}/.codex/config.toml${reset}
-  - Agent defs: ${cyan}${codexDir}/agents/gsd-*.md${reset}
+  - AGENTS.md: ${cyan}${displayRoot}/AGENTS.md${reset}
+  - Native skills: ${cyan}${displayRoot}/skills/gsd-*/SKILL.md${reset}
+  - Config: ${cyan}${displayRoot}/.codex/config.toml${reset}
+  - Agent defs: ${cyan}${displayRoot}/agents/gsd-*.md${reset}
 
   ${yellow}Getting Started:${reset}
   1. Run ${cyan}codex${reset} (CLI) or ${cyan}codex app${reset} (Desktop)
@@ -546,12 +564,12 @@ function installCore(isGlobal, migrationPlan, applyMigration, done = () => {}) {
   }
 }
 
-function install(isGlobal, done = () => {}) {
-  const { codexDir } = getInstallContext(isGlobal);
+function install(isGlobal, done = () => {}, targetPath) {
+  const { codexDir } = getInstallContext(isGlobal, targetPath);
   const migrationPlan = detectMigrationPlan(codexDir);
 
   if (!migrationPlan.hasChanges) {
-    installCore(isGlobal, migrationPlan, false, done);
+    installCore(isGlobal, migrationPlan, false, done, targetPath);
     return;
   }
 
@@ -560,13 +578,13 @@ function install(isGlobal, done = () => {}) {
 
   if (hasMigrate) {
     console.log(`  ${green}✓${reset} Migration approved by --migrate`);
-    installCore(isGlobal, migrationPlan, true, done);
+    installCore(isGlobal, migrationPlan, true, done, targetPath);
     return;
   }
 
   if (hasSkipMigrate) {
     console.log(`  ${yellow}Skipping migration due to --skip-migrate.${reset}`);
-    installCore(isGlobal, migrationPlan, false, done);
+    installCore(isGlobal, migrationPlan, false, done, targetPath);
     return;
   }
 
@@ -589,7 +607,7 @@ function install(isGlobal, done = () => {}) {
     if (!applyMigration) {
       console.log(`  ${yellow}Keeping legacy files.${reset}`);
     }
-    installCore(isGlobal, migrationPlan, applyMigration, done);
+    installCore(isGlobal, migrationPlan, applyMigration, done, targetPath);
   });
 }
 
@@ -614,8 +632,14 @@ function promptLocation(done) {
   });
 }
 
-if (hasGlobal && hasLocal) {
-  console.error(`  ${yellow}Cannot specify both --global and --local${reset}`);
+const locationFlagCount = [hasGlobal, hasLocal, !!customPath].filter(Boolean).length;
+if (locationFlagCount > 1) {
+  console.error(`  ${yellow}Cannot specify more than one of --global, --local, and --path${reset}`);
+  process.exit(1);
+}
+
+if (pathIdx !== -1 && !customPath) {
+  console.error(`  ${yellow}--path requires a directory argument${reset}`);
   process.exit(1);
 }
 
@@ -634,21 +658,23 @@ if (!hasNoVersionCheck && !hasVerify) {
 }
 
 if (hasVerify) {
-  const isGlobal = hasLocal ? false : true;
-  let result = verifyInstall(isGlobal);
+  const isGlobal = customPath ? false : (hasLocal ? false : true);
+  let result = verifyInstall(isGlobal, customPath);
 
   if (!result.ok && hasRepair) {
     console.log(`\n  ${yellow}Repairing install...${reset}\n`);
     install(isGlobal, () => {
       console.log('');
-      const repaired = verifyInstall(isGlobal);
+      const repaired = verifyInstall(isGlobal, customPath);
       process.exit(repaired.ok ? 0 : 1);
-    });
+    }, customPath);
   } else {
     process.exit(result.ok ? 0 : 1);
   }
 } else {
-  if (hasGlobal) {
+  if (customPath) {
+    install(false, () => {}, customPath);
+  } else if (hasGlobal) {
     install(true);
   } else if (hasLocal) {
     install(false);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@undeemed/get-shit-done-codex",
-  "version": "1.22.1",
-  "description": "A meta-prompting, context engineering and spec-driven development system for OpenAI Codex (CLI and Desktop). Fork of get-shit-done by TÂCHES, adapted for Codex by undeemed.",
+  "version": "1.23.1",
+  "description": "A meta-prompting, context engineering and spec-driven development system for OpenAI Codex (CLI and Desktop). Fork of get-shit-done by TÂCHES, adapted for Codex.",
   "bin": {
     "get-shit-done-codex": "bin/install.js"
   },