@bike4mind/cli 0.2.8-feat-cli-context-file-loading.17148 → 0.2.8-feat-cli-context-file-loading.17149

package/README.md

@@ -10,6 +10,7 @@ Interactive command-line interface for Bike4Mind with ReAct agents.
 - 🛠️ B4M tools + MCP integration
 - 🎨 Rich terminal UI with Ink
 - 🐛 Debug logging with `--verbose` flag
+- 📄 Context file loading (CLAUDE.md, AGENTS.md, AI.md)
 
 ## Installation
 
@@ -241,6 +242,51 @@ You can also run any MCP server via npx or custom executables:
 
 **Note:** Internal MCP servers must be built and available in the `b4m-core/packages/mcp/dist/src/` directory. The CLI will automatically find them if you're running from the monorepo. For Docker-based servers, ensure Docker is installed and the image is accessible.
 
+## Context Files
+
+The CLI supports loading project-specific instructions from context files, similar to CLAUDE.md in Claude Code. These files provide persistent instructions that are automatically included in the agent's system prompt.
+
+### Supported Files
+
+**Project-level** (in your project directory, checked in priority order):
+1. `CLAUDE.local.md` - Personal/gitignored instructions (highest priority)
+2. `CLAUDE.md` - Project instructions
+3. `AGENTS.md` - Cross-tool standard
+4. `AI.local.md` - Personal/gitignored instructions
+5. `AI.md` - Project instructions
+6. `INSTRUCTIONS.md` - Project instructions (lowest priority)
+
+**Global** (in `~/.bike4mind/`):
+1. `AI.local.md` - Personal global instructions
+2. `AI.md` - Global instructions
+
+### How It Works
+
+- The CLI loads the **first matching file** from each layer (global and project)
+- Project files take precedence over global files
+- `.local.md` variants are intended to be gitignored for personal preferences
+- Files must be under 100KB
+- Symlinks are rejected for security
+
+### Example
+
+Create a `CLAUDE.md` in your project:
+
+```markdown
+# Project Instructions
+
+- Always use TypeScript strict mode
+- Prefer functional components with hooks
+- Run tests before committing
+```
+
+On startup, you'll see:
+```
+📄 Project context: CLAUDE.md
+```
+
+The agent will follow these instructions for all interactions in that project.
+
 ## Session Storage
 
 Sessions are saved to `~/.bike4mind/sessions/`
@@ -338,6 +384,7 @@ Current implementation includes:
 ✅ B4M tools integration
 ✅ MCP tools support
 ✅ Debug logging with --verbose flag
+✅ Context file loading (CLAUDE.md, AGENTS.md, AI.md)
 
 Coming soon:
 

package/dist/index.js

@@ -10637,7 +10637,7 @@ import { isAxiosError as isAxiosError2 } from "axios";
 // package.json
 var package_default = {
   name: "@bike4mind/cli",
-  version: "0.2.8-feat-cli-context-file-loading.17148+ce4df6add",
+  version: "0.2.8-feat-cli-context-file-loading.17149+1a918591e",
   type: "module",
   description: "Interactive CLI tool for Bike4Mind with ReAct agents",
   license: "UNLICENSED",
@@ -10740,10 +10740,10 @@ var package_default = {
   },
   devDependencies: {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.38.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/mcp": "1.20.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/services": "2.33.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/utils": "2.1.3-feat-cli-context-file-loading.17148+ce4df6add",
+    "@bike4mind/common": "2.38.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/mcp": "1.20.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/services": "2.33.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/utils": "2.1.3-feat-cli-context-file-loading.17149+1a918591e",
     "@types/better-sqlite3": "^7.6.12",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -10756,7 +10756,7 @@ var package_default = {
     typescript: "^5.9.3",
     vitest: "^3.2.4"
   },
-  gitHead: "ce4df6add3c7091ebe97f2b87790ef684c56404d"
+  gitHead: "1a918591e2031dfd0197eab12dccf8e5a2db737e"
 };
 
 // src/config/constants.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.2.8-feat-cli-context-file-loading.17148+ce4df6add",
+  "version": "0.2.8-feat-cli-context-file-loading.17149+1a918591e",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -103,10 +103,10 @@
   },
   "devDependencies": {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.38.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/mcp": "1.20.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/services": "2.33.2-feat-cli-context-file-loading.17148+ce4df6add",
-    "@bike4mind/utils": "2.1.3-feat-cli-context-file-loading.17148+ce4df6add",
+    "@bike4mind/common": "2.38.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/mcp": "1.20.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/services": "2.33.2-feat-cli-context-file-loading.17149+1a918591e",
+    "@bike4mind/utils": "2.1.3-feat-cli-context-file-loading.17149+1a918591e",
     "@types/better-sqlite3": "^7.6.12",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -119,5 +119,5 @@
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   },
-  "gitHead": "ce4df6add3c7091ebe97f2b87790ef684c56404d"
+  "gitHead": "1a918591e2031dfd0197eab12dccf8e5a2db737e"
 }