agent-calling 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# Agent Calling
+
+Calling other proxies and language models within the Gemini CLI.
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+- [x] Claude code
+- [ ] Codex
+
+---
+
+## Core Architecture
+
+Agent Calling integrates Claude into the Gemini CLI ecosystem through three key mechanisms:
+
+1.  **Path Hijacking**: Creates a temporary directory containing a proxy script named `claude` (or `claude.cmd`) and forces this directory to the front of the system `PATH` environment variable.
+2.  **Context Injection**: The proxy script injects the current state of the Gemini CLI (such as workspace paths) as environment variables, allowing Claude to be aware of the Gemini context.
+3.  **Lifecycle Monitoring**: The proxy script sends notifications before and after calling the actual Claude CLI, enabling the host (Gemini CLI) to synchronize UI states or execute subsequent logic.
+
+---
+
+## Installation
+
+### 1. Prerequisites
+*   **Official Claude CLI**: Ensure that Anthropic's `claude` command-line tool is installed and configured on your system.
+*   **Node.js Environment**: Node.js 18+ is recommended.
+
+### 2. Method 1: Gemini CLI Direct Installation
+```bash
+gemini extension install https://github.com/xuansheep/agent-calling
+cd ~/.gemini/extensions/agent-calling
+npm install
+npm run build
+```
+
+### 3. Method 2: Via npm
+```bash
+npm install -g agent-calling
+```
+
+---
+
+## Usage
+
+### 1. Direct Command Invocation
+Once installed, Gemini CLI will expose a tool named `claude`. You can send instructions directly:
+
+```bash
+gemini claude "Analyze the architecture of src/index.ts and suggest refactorings"
+```
+
+### 2. Advanced Parameter Passthrough
+You can pass additional command-line options to the original Claude CLI via the `args` parameter:
+
+```bash
+gemini claude "Scan codebase" --args "--output-format json"
+```
+
+---
+
+## Automation (GEMINI.md)
+
+To achieve automatic delegation of complex tasks, this project includes a `GEMINI.md` configuration file. When you perform the following operations in the Gemini CLI, the Agent will automatically invoke this extension based on the instruction set:
+
+### Delegation Criteria
+- **System Architecture Analysis**: e.g., "Analyze overall project architecture", "Identify dependencies between modules".
+- **Long-term Planning**: e.g., "Generate a detailed implementation plan", "Create a refactoring roadmap".
+- **Deep Code Review**: e.g., "Scan the codebase for potential security vulnerabilities".
+- **Complex Refactoring Suggestions**: Involving decoupling logic or pattern refactoring.
+
+### Automated Execution Protocol
+1.  **Context Injection**: The Agent automatically injects the list of files currently being processed or related documents into the `prompt`.
+2.  **Structured Output**: Claude is required to return results in JSON format by default (e.g., using `--output-format json`) for subsequent automated processing.

package/README.zh-CN.md

@@ -0,0 +1,73 @@
+# Agent Calling (Gemini CLI 增强扩展)
+
+在 Gemini CLI 中调用其他代理和语言模型。
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+- [x] Claude code
+- [ ] Codex
+
+---
+
+## 核心架构原理
+
+Agent Calling 通过以下三个核心机制将 Claude 融入 Gemini CLI 生态系统：
+
+1.  **路径劫持**: 创建一个包含名为 `claude`（或 `claude.cmd`）的代理脚本的临时目录，并将该目录强行置于系统 `PATH` 环境变量的最前面。
+2.  **上下文注入**: 在代理脚本中，将 Gemini CLI 的当前状态（如工作区路径）作为环境变量注入，使 Claude 能够感知 Gemini 的上下文。
+3.  **生命周期监听**: 代理脚本在调用真正的 Claude CLI 前后发送通知，以便宿主（Gemini CLI）同步 UI 状态或执行后续逻辑。
+
+---
+
+## 安装说明
+
+### 1. 先决条件
+*   **安装官方 Claude CLI**: 确保系统中已安装并配置好 Anthropic 的 `claude` 命令行工具。
+*   **Node.js 环境**: 建议使用 Node.js 18+。
+
+### 2. 方式一：Gemini CLI 直接安装
+```bash
+gemini extension install https://github.com/xuansheep/agent-calling
+cd ~/.gemini/extensions/agent-calling
+npm install
+npm run build
+```
+
+### 3. 方式二：使用 npm
+```bash
+npm install -g agent-calling
+```
+
+---
+
+## 使用方法
+
+### 1. 通过命令行直接调用
+安装完成后，Gemini CLI 将暴露一个名为 `claude` 的工具。你可以直接发送指令：
+
+```bash
+gemini claude "分析 src/index.ts 的架构并提出重构建议"
+```
+
+### 2. 高级参数透传
+你可以通过 `args` 参数向原始 Claude CLI 传递额外的命令行选项：
+
+```bash
+gemini claude "扫描代码库" --args "--output-format json"
+```
+
+---
+
+## 自动化执行 (GEMINI.md)
+
+为了实现复杂任务的自动委派，本项目包含了一个 `GEMINI.md` 配置文件。当你在 Gemini CLI 中执行以下操作时，Agent 将根据指令集自动调用本扩展：
+
+### 任务委派准则
+- **系统架构分析**: 如“分析项目整体架构”、“识别模块间依赖关系”。
+- **长程计划制定**: 如“生成详细的项目实现计划”、“制定重构路线图”。
+- **深度代码审查**: 如“扫描代码库中的潜在安全漏洞”。
+- **复杂重构建议**: 涉及项目逻辑解耦或模式重构。
+
+### 自动化执行协议
+1.  **上下文注入**: Agent 自动将当前处理的文件列表或相关文档注入到 `prompt`。
+2.  **结构化输出**: 默认要求 Claude 返回 JSON 格式（如使用 `--output-format json`），以便后续自动化处理。

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,197 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+/**
+ * Generate proxy wrapper script (Windows uses .cmd, Unix uses Bash)
+ */
+function generateWrapperScript(wrapperPath, port) {
+    const isWindows = os.platform() === 'win32';
+    const CRLF = '\r\n';
+    let scriptContent = '';
+    if (isWindows) {
+        scriptContent = [
+            '@echo off',
+            'setlocal',
+            'set GEMINI_CLI_WORKSPACE_ID=current-workspace-id',
+            `powershell -NoProfile -Command "Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:${port}/notify' -Body '{\\"status\\": \\"starting\\", \\"agent\\": \\"run_claude\\"}' -ContentType 'application/json'" > nul 2>&1`,
+            'set REAL_CLAUDE=',
+            'for /f "tokens=*" %%i in (\'where claude\') do (',
+            '    if /i not "%%i"=="%~f0" (',
+            '        set REAL_CLAUDE="%%i"',
+            '        goto :found',
+            '    )',
+            ')',
+            ':found',
+            'if "%REAL_CLAUDE%"=="" (',
+            '    echo Original Claude CLI not found in system, please install it first.',
+            '    exit /b 1',
+            ')',
+            '%REAL_CLAUDE% %*',
+            'set EXIT_CODE=%ERRORLEVEL%',
+            `powershell -NoProfile -Command "Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:${port}/notify' -Body '{\\"status\\": \\"finished\\", \\"exit_code\\": \\"%EXIT_CODE%\\"}' -ContentType 'application/json'" > nul 2>&1`,
+            'exit /b %EXIT_CODE%'
+        ].join(CRLF);
+    }
+    else {
+        scriptContent = `#!/usr/bin/env bash
+export GEMINI_CLI_WORKSPACE_ID="current-workspace-id"
+curl -s -X POST http://127.0.0.1:${port}/notify -d '{"status": "starting", "agent": "run_claude"}' > /dev/null
+REAL_CLAUDE=$(which -a claude | grep -v "$0" | head -n 1)
+if [ -z "$REAL_CLAUDE" ]; then
+  echo "Original Claude CLI not found in system, please install it first."
+  exit 1
+fi
+"$REAL_CLAUDE" "$@"
+EXIT_CODE=$?
+curl -s -X POST http://127.0.0.1:${port}/notify -d '{"status": "finished", "exit_code": "'"$EXIT_CODE"'"}' > /dev/null
+exit $EXIT_CODE
+`;
+    }
+    fs.writeFileSync(wrapperPath, scriptContent, { mode: 0o755 });
+}
+async function runClaude(prompt, extraArgs = []) {
+    const wrapperDir = path.join(os.tmpdir(), 'gemini-cli-wrappers');
+    if (!fs.existsSync(wrapperDir)) {
+        fs.mkdirSync(wrapperDir, { recursive: true });
+    }
+    const isWindows = os.platform() === 'win32';
+    const wrapperName = isWindows ? 'claude.cmd' : 'claude';
+    const wrapperPath = path.join(wrapperDir, wrapperName);
+    const port = process.env.GEMINI_CLI_PORT || "8080";
+    generateWrapperScript(wrapperPath, port);
+    const originalPath = process.env.PATH || '';
+    const pathSeparator = isWindows ? ';' : ':';
+    const customEnv = {
+        ...process.env,
+        PATH: `${wrapperDir}${pathSeparator}${originalPath}`,
+        GEMINI_CLI_PORT: port
+    };
+    // Integrate parameters
+    const finalArgs = [...extraArgs];
+    if (prompt) {
+        finalArgs.push('-p', prompt);
+    }
+    return new Promise((resolve) => {
+        let output = '';
+        const child = (0, child_process_1.spawn)(isWindows ? 'claude.cmd' : 'claude', finalArgs, {
+            env: customEnv,
+            shell: isWindows,
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        child.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            output += data.toString();
+        });
+        child.on('close', (code) => {
+            resolve({ output, exitCode: code || 0 });
+        });
+        child.on('error', (err) => {
+            resolve({ output: `Error: ${err.message}`, exitCode: 1 });
+        });
+    });
+}
+// Create MCP Server
+const server = new index_js_1.Server({
+    name: "claude-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "run_claude",
+                description: "Invokes Anthropic's Claude CLI. Supports complex codebase analysis, architectural design, and planning. It automatically injects current workspace context and hijacks the PATH environment variable. Note: When calling in a sub-agent, be sure to use the full tool name 'agent-claude__run_claude'.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        prompt: {
+                            type: "string",
+                            description: "Prompt or instruction sent to Claude CLI."
+                        },
+                        args: {
+                            type: "array",
+                            items: {
+                                type: "string"
+                            },
+                            description: "Original command-line arguments passed through to Claude CLI."
+                        }
+                    },
+                    required: ["prompt"]
+                }
+            }
+        ]
+    };
+});
+// Tool call handler
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    if (request.params.name === "run_claude") {
+        const { prompt, args } = request.params.arguments;
+        const result = await runClaude(prompt, args);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.output,
+                },
+            ],
+            isError: result.exitCode !== 0,
+        };
+    }
+    throw new Error(`Tool not found: ${request.params.name}`);
+});
+// Start server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Agent Claude (MCP Server) started.");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "agent-calling",
+  "version": "1.0.0",
+  "description": "A Gemini CLI plugin that wraps Claude CLI with path hijacking.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xuansheep/agent-calling.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6"
+  }
+}