@danwahl/gemini-cli-mcp 0.1.5 → 0.1.7

package/README.md

@@ -34,16 +34,16 @@ npm run build
 **User install** (available across all projects):
 
 ```sh
-claude mcp add --scope user gemini npx -- -y @danwahl/gemini-cli-mcp
+claude mcp add gemini-cli -s user -- npx -y @danwahl/gemini-cli-mcp
 ```
 
 **Project install** (shared with your team via `.mcp.json`):
 
 ```sh
-claude mcp add --scope project gemini npx -- -y @danwahl/gemini-cli-mcp
+claude mcp add gemini-cli -s project -- npx -y @danwahl/gemini-cli-mcp
 ```
 
-Or from source, replace `npx @danwahl/gemini-cli-mcp` with `node /absolute/path/to/gemini-cli-mcp/cli.js`.
+Or from source, replace `npx -y @danwahl/gemini-cli-mcp` with `node /absolute/path/to/gemini-cli-mcp/dist/index.js`.
 
 Verify with `claude mcp list`.
 
@@ -96,7 +96,7 @@ Gemini runs with `--approval-mode yolo`, giving it full tool access: read/write
 ## Development
 
 ```sh
-npm run build   # compile with tsdown
+npm run build   # compile with tsc
 npm test        # run unit tests
 ```
 

package/dist/index.js

@@ -10,9 +10,20 @@ const server = new McpServer({
     version,
 });
 server.registerTool("cli", {
-    description: "Send a task or question to Gemini CLI and return the response. " +
-        "Gemini runs headlessly with full tool access (file read/write, web search, shell commands). " +
-        "Use this to delegate tasks that benefit from Gemini's capabilities or to get a second opinion.",
+    description: "Send a task to Gemini CLI and return the response. " +
+        "Gemini runs headlessly with full tool access (file read/write, web search, shell commands) " +
+        "and operates in the working directory you specify via `cwd`.\n\n" +
+        "When to use this tool:\n" +
+        "- Delegating rote coding tasks: boilerplate generation, repetitive refactors, bulk edits across many files\n" +
+        "- Getting a second opinion: code review, architecture feedback, sanity-checking an approach\n" +
+        "- Research and brainstorming: Gemini has web search and a large context window, useful for exploring options or summarizing docs\n" +
+        "- Large file analysis: processing files that would be expensive to handle directly\n" +
+        "- Parallel workstreams: offloading independent subtasks while you continue other work\n\n" +
+        "Session resumption: each response includes a `sessionId`. " +
+        "Pass it back via the `sessionId` parameter to continue a conversation " +
+        "without re-sending context — useful for multi-step tasks or follow-up questions.\n\n" +
+        "Keep prompts self-contained: include all necessary context in the `prompt` since " +
+        "Gemini has no access to your conversation history or MCP state.",
     inputSchema: {
         prompt: z
             .string()
@@ -31,6 +42,11 @@ server.registerTool("cli", {
             .string()
             .optional()
             .describe("Resume a previous Gemini session by ID. The session ID is returned in the structured output of each call."),
+        timeout: z
+            .number()
+            .optional()
+            .default(120)
+            .describe("Timeout in seconds. Default: 120. Increase for complex multi-step tasks."),
     },
     outputSchema: {
         sessionId: z.string().nullable().describe("Gemini CLI session ID"),
@@ -42,8 +58,8 @@ server.registerTool("cli", {
         readOnlyHint: false,
         openWorldHint: true,
     },
-}, async ({ prompt, cwd, model, sessionId }) => {
-    const timeoutMs = 120_000;
+}, async ({ prompt, cwd, model, sessionId, timeout }) => {
+    const timeoutMs = (timeout ?? 120) * 1000;
     const result = await runGemini(prompt, cwd, model, timeoutMs, sessionId);
     if (result.isError) {
         return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@danwahl/gemini-cli-mcp",
   "type": "module",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "MCP server that exposes Gemini CLI as a single tool for Claude Code",
   "license": "MIT",
   "repository": {