mother-brain 0.3.0 → 0.4.0

package/dist/cli.js

@@ -20,6 +20,7 @@ var __dirname = path.dirname(__filename);
 async function init(options = {}) {
   const cwd = process.cwd();
   const skillsDir = path.join(cwd, ".github", "skills");
+  const agentsSkillsDir = path.join(cwd, ".agents", "skills");
   const motherBrainDir = path.join(cwd, ".mother-brain");
   console.log("");
   console.log(chalk.cyan("\u2533\u2533\u2513\u250F\u2513\u250F\u2533\u2513\u2513\u250F\u250F\u2513\u2533\u2513  \u2533\u2513\u2533\u2513\u250F\u2513\u2533\u2533\u2513"));
@@ -76,12 +77,44 @@ async function init(options = {}) {
   console.log(chalk.cyan("\n\u2705 Mother Brain initialized!\n"));
   console.log("Next steps:");
   console.log(chalk.dim("  1. Commit the new files to your repo"));
-  console.log(chalk.dim("  2. Open GitHub Copilot CLI"));
-  console.log(chalk.dim("  3. Type: /mother-brain\n"));
+  console.log(chalk.dim("  2. Open your AI CLI:"));
+  console.log(chalk.dim('     GitHub Copilot CLI: ghcs "/mother-brain"'));
+  console.log(chalk.dim("     Codex CLI:          $mother-brain"));
+  console.log(chalk.dim("  3. Follow the wizard to define your vision\n"));
   if (copiedCount > 0) {
     console.log(chalk.green(`Added ${copiedCount} skill(s) to .github/skills/`));
   }
   console.log(chalk.green("Created .mother-brain/ for project state\n"));
+  await fs.ensureDir(path.join(cwd, ".agents", "skills"));
+  let symlinkCount = 0;
+  for (const skill of coreSkills) {
+    const target = path.join(skillsDir, skill);
+    const link = path.join(agentsSkillsDir, skill);
+    if (await fs.pathExists(target)) {
+      try {
+        if (await fs.pathExists(link)) {
+          const stat = await fs.lstat(link);
+          if (stat.isSymbolicLink()) {
+            await fs.remove(link);
+          } else if (!options.force) {
+            console.log(chalk.yellow(`  \u26A0 .agents/skills/${skill} exists (not a symlink, skipping)`));
+            continue;
+          } else {
+            await fs.remove(link);
+          }
+        }
+        await fs.symlink(target, link, "junction");
+        symlinkCount++;
+      } catch (err) {
+        console.log(chalk.yellow(`  \u26A0 Symlink failed for ${skill}, copying instead`));
+        await fs.copy(target, link, { overwrite: true });
+        symlinkCount++;
+      }
+    }
+  }
+  if (symlinkCount > 0) {
+    console.log(chalk.green(`Linked ${symlinkCount} skill(s) to .agents/skills/ (Codex CLI compatible)`));
+  }
 }
 
 // src/commands/update.ts
@@ -97,6 +130,7 @@ var __dirname2 = path2.dirname(__filename2);
 async function update() {
   const cwd = process.cwd();
   const skillsDir = path2.join(cwd, ".github", "skills");
+  const agentsSkillsDir = path2.join(cwd, ".agents", "skills");
   const motherBrainDir = path2.join(cwd, ".mother-brain");
   const versionFile = path2.join(motherBrainDir, "version.json");
   console.log(chalk2.cyan("\n\u{1F9E0} Updating Mother Brain...\n"));
@@ -155,6 +189,28 @@ async function update() {
 \u2705 Updated to v${latestVersion}!
 `));
     console.log(chalk2.dim("Don't forget to commit the updated files.\n"));
+    if (await fs2.pathExists(agentsSkillsDir)) {
+      for (const skill of coreSkills) {
+        const target = path2.join(skillsDir, skill);
+        const link = path2.join(agentsSkillsDir, skill);
+        if (await fs2.pathExists(target)) {
+          try {
+            if (await fs2.pathExists(link)) {
+              const stat = await fs2.lstat(link);
+              if (stat.isSymbolicLink()) {
+                continue;
+              }
+              await fs2.copy(target, link, { overwrite: true });
+            } else {
+              await fs2.symlink(target, link, "junction");
+            }
+          } catch {
+            await fs2.copy(target, link, { overwrite: true });
+          }
+        }
+      }
+      console.log(chalk2.green("Refreshed .agents/skills/ (Codex CLI compatible)"));
+    }
   } catch (error) {
     console.log(chalk2.red("Failed to download update."));
     console.log(chalk2.dim("Try running: npx mother-brain@latest init --force\n"));
@@ -653,8 +709,8 @@ async function uninstall(options) {
 // src/cli.ts
 import { exec as exec3 } from "child_process";
 var program = new Command();
-var VERSION = "0.3.0";
-program.name("mother-brain").description("AI-powered project management framework for GitHub Copilot CLI").version(VERSION);
+var VERSION = "0.4.0";
+program.name("mother-brain").description("AI-powered project management framework for GitHub Copilot CLI and Codex CLI").version(VERSION);
 program.command("init").description("Initialize Mother Brain in the current project").option("-f, --force", "Overwrite existing skills").action(init);
 program.command("update").description("Update Mother Brain skills to the latest version").action(update);
 program.command("status").description("Show installed version and available updates").action(status);
@@ -680,8 +736,9 @@ program.command("quickstart").description("Show quick start guide").action(() =>
   console.log(chalk6.white.bold("\u{1F680} Quick Start Guide\n"));
   console.log(chalk6.yellow("Step 1:") + " Initialize Mother Brain in your project");
   console.log(chalk6.dim("  npx -y mother-brain init\n"));
-  console.log(chalk6.yellow("Step 2:") + " Start using it with GitHub Copilot CLI");
-  console.log(chalk6.dim('  ghcs "/mother-brain"\n'));
+  console.log(chalk6.yellow("Step 2:") + " Start using it with your AI CLI");
+  console.log(chalk6.dim('  GitHub Copilot CLI: ghcs "/mother-brain"'));
+  console.log(chalk6.dim("  Codex CLI:          $mother-brain\n"));
   console.log(chalk6.yellow("Step 3:") + " Follow the wizard to define your vision");
   console.log(chalk6.dim("  Mother Brain will guide you through:\n"));
   console.log(chalk6.dim("  - Vision Discovery (what are you building?)"));
@@ -698,7 +755,7 @@ program.action(() => {
 \u2503\u2503\u2503\u2503\u2503 \u2503 \u2523\u252B\u2523 \u2523\u252B  \u2523\u252B\u2523\u252B\u2523\u252B\u2503\u2503\u2503
 \u251B \u2517\u2517\u251B \u253B \u251B\u2517\u2517\u251B\u251B\u2517  \u253B\u251B\u251B\u2517\u251B\u2517\u253B\u251B\u2517
 `));
-  console.log(chalk6.white("AI-powered project management for GitHub Copilot CLI"));
+  console.log(chalk6.white("AI-powered project management for GitHub Copilot CLI & Codex CLI"));
   console.log(chalk6.dim(`v${VERSION}
 `));
   console.log(chalk6.white.bold("Getting Started:"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mother-brain",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI-powered project management framework for GitHub Copilot CLI",
   "type": "module",
   "main": "dist/index.js",

package/skills/mother-brain/SKILL.md

@@ -2271,8 +2271,24 @@ This pattern ensures NO workflow ever traps the user—there's always an escape
      New-Item -ItemType Directory -Path ".mother-brain/docs/tasks" -Force
      New-Item -ItemType Directory -Path ".mother-brain/docs/research" -Force
      New-Item -ItemType Directory -Path ".github/skills" -Force
+     New-Item -ItemType Directory -Path ".agents/skills" -Force
      ```
    
+   - Create `.agents/skills/` symlinks for Codex CLI compatibility:
+     ```powershell
+     # Symlink each core skill so Codex CLI can discover them
+     # Uses 'junction' on Windows (works without admin/dev mode)
+     $coreSkills = @("mother-brain", "child-brain", "skill-creator")
+     foreach ($skill in $coreSkills) {
+       $target = ".github\skills\$skill"
+       $link = ".agents\skills\$skill"
+       if ((Test-Path $target) -and !(Test-Path $link)) {
+         New-Item -ItemType Junction -Path $link -Target (Resolve-Path $target) -Force
+       }
+     }
+     ```
+   - **Why symlinks**: Skills live in `.github/skills/` (GitHub Copilot CLI) and are symlinked to `.agents/skills/` (Codex CLI). One source of truth, both CLIs can discover them.
+   
    - Create initial version tracking:
      ```powershell
      $version = "[current-mother-brain-version]"
@@ -2316,7 +2332,7 @@ This pattern ensures NO workflow ever traps the user—there's always an escape
      ✅ Mother Brain initialized!
      
      📁 Location: [current directory]
-     📂 Created: .mother-brain/, .github/skills/
+     📂 Created: .mother-brain/, .github/skills/, .agents/skills/ (symlinked)
      🔗 Git: [Initialized / Already existed]
      
      Ready to create your vision document.
@@ -2706,6 +2722,10 @@ This pattern ensures NO workflow ever traps the user—there's always an escape
            ```
          - Let skill-creator run its wizard with all three knowledge sources
          - **Store created skills in `.github/skills/`** (CLI-discoverable location)
+         - **Symlink to `.agents/skills/`** for Codex CLI compatibility:
+           ```powershell
+           New-Item -ItemType Junction -Path ".agents\skills\[skill-name]" -Target (Resolve-Path ".github\skills\[skill-name]") -Force
+           ```
          - **Track in session-state.json**: Add skill name to `skillsCreated` array
          - **VALIDATE SKILL** (CRITICAL - prevents task execution failures):
            1. Check `.github/skills/[skill-name]/SKILL.md` exists
@@ -4034,6 +4054,11 @@ project-root/
 │       ├── skill-creator/            # Core framework (never delete)
 │       ├── [project-skill-1]/        # Project-specific (tracked in session-state.json)
 │       └── [project-skill-2]/        # Project-specific (tracked in session-state.json)
+├── .agents/
+│   └── skills/                       # Symlinks to .github/skills/ (Codex CLI compatibility)
+│       ├── mother-brain/ → ../.github/skills/mother-brain/
+│       ├── child-brain/  → ../.github/skills/child-brain/
+│       └── skill-creator/ → ../.github/skills/skill-creator/
 ├── src/                              # Source code (standard structure)
 ├── tests/                            # Tests (standard structure)
 ├── README.md                         # Project overview
@@ -4041,7 +4066,7 @@ project-root/
 ```
 
 **Key Principles:**
-- **CLI Compatibility**: All skills in `.github/skills/` so Copilot CLI can find them
+- **Dual CLI Compatibility**: Skills live in `.github/skills/` (GitHub Copilot CLI) and are symlinked to `.agents/skills/` (Codex CLI). One source of truth, both CLIs discover them.
 - **Skill Tracking**: `session-state.json` tracks which skills are project-specific via `skillsCreated` array
 - **Easy Ejection**: Delete skills listed in `skillsCreated`, keep core framework skills
 - **Isolated Docs**: Project documentation in `.mother-brain/docs/` (separate from project code)