@maxanatsko/llm-cli-bridge 3.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License (Non-Commercial)
+
+Copyright (c) 2025 jamubc
+Copyright (c) 2025 Maxim Anatsko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software for non-commercial purposes only, including without limitation 
+the rights to use, copy, modify, merge, publish, and distribute copies of the 
+Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+Commercial use of this software is prohibited without prior written permission 
+from the copyright holder. For commercial licensing, please contact the 
+copyright holder directly.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# LLM CLI Bridge
+
+<br>
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│   Model Context Protocol server for Gemini CLI + Codex CLI      │
+│                                                                 │
+│   Claude ──────────── Gemini / Codex                            │
+│                                                                 │
+│   Leverage Gemini's massive token window or Codex's             │
+│   advanced reasoning for large file and codebase analysis       │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+<br>
+
+**Version** `3.1.0`
+**License** `MIT`
+
+---
+
+<br>
+
+## Prerequisites
+
+```
+Node.js ≥ 16.0.0
+Google Gemini CLI (configured)
+```
+
+<br>
+
+---
+
+<br>
+
+## Installation
+
+<br>
+
+### Recommended
+
+```bash
+claude mcp add llm-cli -- npx -y @maxanatsko/llm-cli-bridge
+```
+
+<br>
+
+### Local Development
+
+```bash
+git clone https://github.com/maxanatsko/llm-cli-bridge.git
+cd llm-cli-bridge
+
+npm install
+npm run build
+npm link
+
+claude mcp add llm-cli -- llm-cli-bridge
+```
+
+<br>
+
+### Verify
+
+```bash
+/mcp
+```
+
+<br>
+
+---
+
+<br>
+
+## Configuration
+
+<br>
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "llm-cli": {
+      "command": "npx",
+      "args": ["-y", "@maxanatsko/llm-cli-bridge"]
+    }
+  }
+}
+```
+
+<br>
+
+### Config Locations
+
+```
+macOS     ~/Library/Application Support/Claude/claude_desktop_config.json
+Windows   %APPDATA%\Claude\claude_desktop_config.json
+Linux     ~/.config/claude/claude_desktop_config.json
+```
+
+<br>
+
+---
+
+<br>
+
+## Usage
+
+<br>
+
+### File Analysis
+
+```
+ask gemini to analyze @src/main.js
+use gemini to summarize @.
+analyze @package.json dependencies
+```
+
+<br>
+
+### General Questions
+
+```
+ask gemini about React best practices
+use gemini to explain div centering
+ask gemini for latest tech news
+```
+
+<br>
+
+### Sandbox Mode
+
+```
+use gemini sandbox to run @script.py
+ask gemini to safely test this code
+use gemini sandbox to install numpy
+```
+
+<br>
+
+---
+
+<br>
+
+## Tools
+
+<br>
+
+| Tool | Description |
+|:-----|:------------|
+| `ask` | Query Gemini or Codex with `@` file references |
+| `ask-gemini` | Backward-compatible alias for `ask` |
+| `brainstorm` | Creative ideation with frameworks |
+| `review-code` | Interactive code review sessions |
+| `ping` | Connection test |
+| `help` | CLI documentation |
+
+<br>
+
+### Parameters
+
+<br>
+
+**ask** (or `ask-gemini`)
+
+```
+prompt      Required    Analysis request with @ syntax
+backend     Optional    gemini (default) | codex
+model       Optional    Backend-specific override
+reasoningEffort Optional Codex-only: low|medium|high|xhigh
+sandbox     Optional    Gemini sandbox / Codex workspace-write
+sandboxMode Optional    Codex-only: read-only|workspace-write|danger-full-access
+session     Optional    Conversation continuity
+includeHistory Optional Include previous rounds
+changeMode  Optional    Structured edit suggestions
+```
+
+<br>
+
+---
+
+<br>
+
+## Links
+
+<br>
+
+[Documentation](https://maxanatsko.github.io/llm-cli-bridge/)
+[Original Project](https://github.com/jamubc/gemini-mcp-tool)
+[GitHub](https://github.com/maxanatsko/llm-cli-bridge)
+
+<br>
+
+---
+
+<br>
+
+<sub>MIT License — Not affiliated with Google</sub>

package/dist/backends/codex.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Codex Backend - Executes prompts via OpenAI's Codex CLI
+ *
+ * Uses `codex exec` for non-interactive execution mode.
+ * Supports native session resume via thread_id from JSON output.
+ * Codex CLI does not support @file syntax, so files must be read and inlined.
+ */
+import { BackendExecutor, BackendConfig, BackendType, BackendResult } from './types.js';
+export declare class CodexBackend implements BackendExecutor {
+    name: BackendType;
+    execute(prompt: string, config: BackendConfig, onProgress?: (output: string) => void): Promise<BackendResult>;
+    isAvailable(): Promise<boolean>;
+    getModels(): string[];
+    supportsFileRefs(): boolean;
+    getFileRefSyntax(): string;
+    private buildArgs;
+    /**
+     * Validate that a resolved path is within the allowed workspace
+     * Prevents path traversal attacks including Windows drive letter escapes
+     */
+    private isPathWithinWorkspace;
+    /**
+     * Translate @file references to inline content
+     * Codex doesn't support @ syntax, so we read files and include their content
+     * Handles paths with dots, slashes, dashes, underscores, and relative paths like @../src/file.ts
+     * Includes path traversal protection to prevent reading files outside workspace
+     */
+    private translateFileRefs;
+    private applyChangeModeInstructions;
+    /**
+     * Parse JSONL output from Codex CLI
+     * Extracts thread_id from thread.started event and response text from message events
+     */
+    private parseJsonOutput;
+    private executeCommand;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/backends/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/backends/codex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAYxF,qBAAa,YAAa,YAAW,eAAe;IAClD,IAAI,EAAE,WAAW,CAAW;IAEtB,OAAO,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,aAAa,CAAC;IA+BnB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,SAAS,IAAI,MAAM,EAAE;IAUrB,gBAAgB,IAAI,OAAO;IAI3B,gBAAgB,IAAI,MAAM;IAI1B,OAAO,CAAC,SAAS;IAsDjB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;OAKG;YACW,iBAAiB;IAmL/B,OAAO,CAAC,2BAA2B;IAInC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkGvB,OAAO,CAAC,cAAc;CAwFvB"}