claude-ide-bridge 2.23.2 → 2.23.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ide-bridge",
-  "version": "2.23.2",
+  "version": "2.23.4",
   "description": "Standalone MCP bridge for Claude Code IDE integration with any editor — 136+ tools for LSP, debugging, terminals, Git, GitHub, and more",
   "type": "module",
   "main": "dist/index.js",

package/templates/CLAUDE.bridge.md

@@ -1,17 +1,19 @@
 ## Claude IDE Bridge
 
 @import .claude/rules/bridge-tools.md
-
 > **BRIDGE TOOL ENFORCEMENT — mandatory when bridge is connected**
-> Do NOT run shell commands. Call MCP bridge tools instead:
+> Do NOT use native Claude Code tools or shell commands for workspace operations:
+> - File reading: `getBufferContent` (not `Read` tool)
+> - File editing: `editText` or `searchAndReplace` (not `Edit`/`Write` tools)
+> - File search: `searchWorkspace` / `findFiles` (not `Grep`/`Glob` tools)
 > - Testing: `runTests` (not `npm test` / `npx vitest`)
 > - Diagnostics: `getDiagnostics` (not `tsc --noEmit` / `npm run lint`)
 > - Git: `gitCommit`, `gitAdd`, `gitPush` (not `git commit` etc.)
-> - Search: `searchWorkspace` (not `grep` / `rg`)
-> - Hover/types: `batchGetHover` (not calling `getHover` in a loop)
+> - Shell commands: `runInTerminal` (not `Bash` tool)
+>
+> **Exceptions:** `Read`/`Edit`/`Write` on files outside the workspace (`~/.claude/`, system paths) have no bridge equivalent.
 >
 > Full substitution table: see `.claude/rules/bridge-tools.md` (loaded above via @import).
-
 The bridge is connected via MCP. The session-start hook reports connection status, tool count, and extension state automatically — check that summary before proceeding. If tools appear missing, call `getBridgeStatus` to diagnose.
 
 ### Bug fix methodology

package/templates/bridge-tools.md

@@ -5,9 +5,21 @@
 > **These rules are active when the `claude-ide-bridge` MCP server is connected** (green in `/mcp`).  
 > If the bridge is not running, fall back to standard shell equivalents.
 
-### MANDATORY: Bridge MCP tools replace shell commands
+### MANDATORY: Bridge MCP tools replace shell commands AND native Claude Code tools
 
-Do NOT run the shell command. Call the MCP tool instead.
+Do NOT use native Claude Code tools or shell commands for workspace operations. Call the MCP tool instead.
+
+#### File I/O — native Claude Code tools replaced by bridge
+
+| ❌ Do NOT use | ✅ Call instead |
+|---|---|
+| `Read` tool on workspace files | `getBufferContent` |
+| `Edit` tool on workspace files | `editText` (line range) or `searchAndReplace` (pattern) |
+| `Write` tool on workspace files | `editText` or `createFile` for new files |
+| `Glob` tool to find files | `findFiles` |
+| `Bash` for build/shell commands | `runInTerminal` |
+
+> **Exceptions:** `Read`/`Edit`/`Write` on files **outside** the workspace (`~/.claude/`, system paths, etc.) have no bridge equivalent — native tools are correct there.
 
 #### Diagnostics & linting