context-bank 0.0.5 → 0.0.7

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

@@ -80,6 +80,32 @@ export async function initCommand(options) {
             const projectName = path.basename(targetDir);
             await fs.writeFile(readmePath, `${aiContextMarker}\n\n# ${projectName}\n`);
         }
+        // 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}`);
+            }
+        }
+        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 {
+            await fs.writeFile(claudePath, `${claudeInstruction}\n`);
+        }
         s.stop(chalk.green("Context initialized!"));
         // Gemini CLI Global Memory Integration
         const globalGeminiDir = path.join(os.homedir(), ".gemini");
@@ -93,7 +119,13 @@ export async function initCommand(options) {
                     initialValue: true
                 });
                 if (addGlobalContext === true) {
-                    const genericContextRule = "- [Context Bank] Always check the current working directory for '.ai/rules.md' and '.ai/active-context.md'. If they exist, follow their instructions as the primary source of truth.";
+                    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`;

package/package.json

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