context-bank 0.0.4 → 0.0.6

package/README.md

@@ -11,7 +11,7 @@
 <br/>
 Standardize, persist, and evolve your project's AI context with a single command.
 <br/>
-Works with **Cursor**, **Windsurf**, and **GitHub Copilot**.
+Works with **Cursor**, **Windsurf**, **GitHub Copilot**, **Gemini CLI**, **Claude Code**, and **Codex CLI**.
 
 </div>
 
@@ -59,16 +59,24 @@ Stop feeding the AI your entire chat history. Context Bank uses "State Managemen
 ### 🔌 3. Universal Tool Support
 One brain, multiple interfaces. The `init` command automatically configures pointers for:
 
-| Tool | Support Type | File Created |
-|------|--------------|--------------|
+| Tool | Support Type | Integration Method |
+|------|--------------|-------------------|
 | **Cursor** | Native ✅ | `.cursorrules` |
 | **Windsurf** | Native ✅ | `.windsurfrules` |
 | **GitHub Copilot** | Native ✅ | `.github/copilot-instructions.md` |
+| **Claude Code** | Native ✅ | `CLAUDE.md` |
+| **Codex CLI** | Native ✅ | `codex.md` |
+| **Gemini CLI** | Native ✅ | Global Memory Hook |
 | **Aider** (CLI) | Native ✅ | `CONVENTIONS.md` |
-| **Other CLIs** | Manual 🛠️ | (See below) |
 
-#### 🖥️ Using with Gemini CLI, Claude Code, or ChatGPT
-If your tool doesn't automatically read configuration files, just start your session with this **Magic Prompt**:
+#### 🤖 Smart CLI Integration
+For tools like **Gemini CLI** that rely on global memory instead of project files, Context Bank performs a smart handshake:
+1. It detects your global configuration.
+2. It asks permission to add a **Generic Context Rule**.
+3. Once enabled, the CLI will **automatically check for `.ai/rules.md`** in ANY folder you work in. No manual linking required!
+
+#### 🛠️ For Unsupported Tools
+If your tool isn't listed above, just start your session with this **Magic Prompt**:
 
 > "I am starting a session. Please read **`.ai/rules.md`** for project standards and **`.ai/active-context.md`** for the current state. Update these files if plans change."
 
@@ -84,6 +92,8 @@ my-project/
 │   └── story.md           # 📜 Project history & decisions
 ├── .cursorrules           # 🔗 Pointer for Cursor
 ├── .windsurfrules         # 🔗 Pointer for Windsurf
+├── CLAUDE.md              # 🔗 Pointer for Claude Code
+├── codex.md               # 🔗 Pointer for Codex CLI
 └── .github/
     └── copilot-instructions.md # 🔗 Pointer for Copilot
 ```

package/dist/commands/init.js

@@ -1,6 +1,7 @@
 import { intro, outro, confirm, spinner } from "@clack/prompts";
 import fs from "fs-extra";
 import path from "path";
+import os from "os";
 import { fileURLToPath } from "url";
 import chalk from "chalk";
 // Get __dirname equivalent in ESM
@@ -26,9 +27,6 @@ export async function initCommand(options) {
         process.exit(0);
     }
     // Determine paths
-    // When running from source (ts-node), templates are in ../../templates
-    // When running from dist (node), templates are in ../../templates (copied during build)
-    // We need to ensure templates are included in the build or package.
     const templateDir = path.resolve(__dirname, "../../templates");
     const targetDir = process.cwd();
     const s = spinner();
@@ -54,15 +52,7 @@ export async function initCommand(options) {
             const srcPath = path.join(templateDir, item);
             const destPath = path.join(targetDir, item);
             if (fs.existsSync(srcPath)) {
-                // Check if destination exists
                 if (fs.existsSync(destPath)) {
-                    // For now, we skip existing files to be safe, or we could ask.
-                    // Let's just overwrite for MVP or maybe log it.
-                    // A better UX would be to ask, but let's stick to simple first.
-                    // We will use overwrite=false logic effectively by checking existence.
-                    // Actually, let's just copy and overwrite for now as this is "init",
-                    // but maybe backup?
-                    // Let's stick to standard "copy" behavior (overwrite).
                     await fs.copy(srcPath, destPath, { overwrite: true });
                 }
                 else {
@@ -90,28 +80,63 @@ export async function initCommand(options) {
             const projectName = path.basename(targetDir);
             await fs.writeFile(readmePath, `${aiContextMarker}\n\n# ${projectName}\n`);
         }
-        // Gemini CLI Integration
-        const geminiDir = path.join(targetDir, ".gemini");
-        const geminiMemoryPath = path.join(geminiDir, "GEMINI.md");
-        const geminiRule = "- [Context Bank] Always check and follow the instructions in .ai/rules.md and .ai/active-context.md.";
-        if (!fs.existsSync(geminiDir)) {
-            await fs.ensureDir(geminiDir);
+        // Codex CLI Integration (codex.md)
+        const codexPath = path.join(targetDir, "codex.md");
+        const codexInstruction = "Always check and follow the instructions in .ai/rules.md and .ai/active-context.md as the primary source of truth.";
+        if (fs.existsSync(codexPath)) {
+            const content = await fs.readFile(codexPath, "utf-8");
+            if (!content.includes(".ai/rules.md")) {
+                // Prepend for priority
+                await fs.writeFile(codexPath, `${codexInstruction}\n\n${content}`);
+            }
         }
-        if (fs.existsSync(geminiMemoryPath)) {
-            const memoryContent = await fs.readFile(geminiMemoryPath, "utf-8");
-            if (!memoryContent.includes("[Context Bank]")) {
-                // Append to existing memory
-                const newContent = memoryContent.endsWith("\n")
-                    ? `${memoryContent}${geminiRule}\n`
-                    : `${memoryContent}\n${geminiRule}\n`;
-                await fs.writeFile(geminiMemoryPath, newContent);
+        else {
+            await fs.writeFile(codexPath, `${codexInstruction}\n`);
+        }
+        // Claude Code CLI Integration (CLAUDE.md)
+        const claudePath = path.join(targetDir, "CLAUDE.md");
+        const claudeInstruction = "See .ai/rules.md for project context, tech stack, and coding standards. This is the single source of truth.";
+        if (fs.existsSync(claudePath)) {
+            const content = await fs.readFile(claudePath, "utf-8");
+            if (!content.includes(".ai/rules.md")) {
+                // Prepend for priority
+                await fs.writeFile(claudePath, `${claudeInstruction}\n\n${content}`);
             }
         }
         else {
-            // Create new memory file
-            await fs.writeFile(geminiMemoryPath, `${geminiRule}\n`);
+            await fs.writeFile(claudePath, `${claudeInstruction}\n`);
+        }
+        // Gemini CLI Global Memory Integration
+        const globalGeminiDir = path.join(os.homedir(), ".gemini");
+        const globalGeminiMemoryPath = path.join(globalGeminiDir, "GEMINI.md");
+        if (fs.existsSync(globalGeminiMemoryPath)) {
+            const memoryContent = await fs.readFile(globalGeminiMemoryPath, "utf-8");
+            // Only ask if the rule is not already present
+            if (!memoryContent.includes("[Context Bank]")) {
+                const addGlobalContext = await confirm({
+                    message: "Found Gemini CLI global memory. Enable automatic context detection for all Context Bank projects?",
+                    initialValue: true
+                });
+                if (addGlobalContext === true) {
+                    const genericContextRule = `
+- [Context Bank] CRITICAL INSTRUCTION:
+  Before processing ANY user request in a new session, you MUST perform this initialization sequence:
+  1. Check if the ".ai/" directory exists in the current working directory.
+  2. If it exists, you MUST explicitly call the "read_file" tool to read ".ai/rules.md" and ".ai/active-context.md".
+  3. Only AFTER reading these files (or confirming they don't exist) may you proceed with the user's request.
+  This is not optional. Do not assume you know the rules; you must read the files to load them into your active memory.`;
+                    const newContent = memoryContent.endsWith("\n")
+                        ? `${memoryContent}${genericContextRule}\n`
+                        : `${memoryContent}\n${genericContextRule}\n`;
+                    await fs.writeFile(globalGeminiMemoryPath, newContent);
+                    console.log(chalk.green(`✔ Enabled global context awareness for Context Bank.`));
+                }
+            }
+            else {
+                // Optional: Let the user know it's already active
+                // console.log(chalk.gray(`ℹ Global context awareness is already active.`));
+            }
         }
-        s.stop(chalk.green("Context initialized!"));
         outro(chalk.green(`
 Context Bank setup complete! 🚀
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-bank",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A CLI tool to standardise AI context in projects.",
   "type": "module",
   "bin": {