feat: add cursor native tools

.gitignore

@@ -1,5 +1,6 @@
 node_modules/
 coverage
 dist/
+docs/
 *.tgz
 .DS_Store

.ignore

@@ -0,0 +1 @@
+!docs/

.release-tools/cache.json

@@ -1,17 +1,17 @@
 {
-	"scripts": {
-		"typecheck": "tsc --noEmit",
-		"knip": "knip --production",
-		"lint": "biome check --write .",
-		"lint:ci": "biome ci .",
-		"check-duplicates": "bunx jscpd src tests --exitCode 1 --reporters ai --noTips",
-		"check": "bun run lint && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
-		"check:ci": "bun run lint:ci && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
-		"prepare": "husky"
-	},
-	"lintStaged": {
-		"*": ["biome check --write --no-errors-on-unmatched"]
-	},
-	"tsconfig": "{\n\t\"compilerOptions\": {\n\t\t\"target\": \"ES2022\",\n\t\t\"module\": \"ES2022\",\n\t\t\"moduleResolution\": \"bundler\",\n\t\t\"strict\": true,\n\t\t\"esModuleInterop\": true,\n\t\t\"skipLibCheck\": true,\n\t\t\"forceConsistentCasingInFileNames\": true,\n\t\t\"resolveJsonModule\": true,\n\t\t\"declaration\": true,\n\t\t\"declarationMap\": true,\n\t\t\"sourceMap\": true,\n\t\t\"outDir\": \"./dist\",\n\t\t\"rootDir\": \".\"\n\t},\n\t\"include\": [\"src/**/*.ts\"],\n\t\"exclude\": [\"node_modules\", \"dist\"]\n}\n",
-	"installedDeps": []
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "knip": "knip --production",
+    "lint": "biome check --write .",
+    "lint:ci": "biome ci .",
+    "check-duplicates": "bunx jscpd src tests --exitCode 1 --reporters ai --noTips",
+    "check": "bun run lint && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
+    "check:ci": "bun run lint:ci && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
+    "prepare": "husky"
+  },
+  "lintStaged": {
+    "*": ["biome check --write --no-errors-on-unmatched"]
+  },
+  "tsconfig": "{\n\t\"compilerOptions\": {\n\t\t\"target\": \"ES2022\",\n\t\t\"module\": \"ES2022\",\n\t\t\"moduleResolution\": \"bundler\",\n\t\t\"strict\": true,\n\t\t\"esModuleInterop\": true,\n\t\t\"skipLibCheck\": true,\n\t\t\"forceConsistentCasingInFileNames\": true,\n\t\t\"resolveJsonModule\": true,\n\t\t\"declaration\": true,\n\t\t\"declarationMap\": true,\n\t\t\"sourceMap\": true,\n\t\t\"outDir\": \"./dist\",\n\t\t\"rootDir\": \".\"\n\t},\n\t\"include\": [\"src/**/*.ts\"],\n\t\"exclude\": [\"node_modules\", \"dist\"]\n}\n",
+  "installedDeps": []
 }

.release-tools/config.ts

@@ -1,7 +1,7 @@
-import { defineConfig } from "release-tools/config";
+import { defineConfig } from 'release-tools/config';
 
 export default defineConfig({
-	packageName: "pi-grok-cli",
-	repo: "kenryu42/pi-grok-cli",
-	excludedAuthors: ["kenryu42"],
+  packageName: 'pi-grok-cli',
+  repo: 'kenryu42/pi-grok-cli',
+  excludedAuthors: ['kenryu42'],
 });

README.md

@@ -4,11 +4,8 @@
 [![Version](https://img.shields.io/github/v/tag/kenryu42/pi-grok-cli?label=version&color=blue)](https://github.com/kenryu42/pi-grok-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)
 
-A pi extension that connects to **Grok CLI's API endpoint** .
-
-## Why?
-
-The Grok CLI uhas access to models **not available** on the public `api.x.ai` API yet:
+A pi extension that connects to **Grok CLI's API endpoint**.
+The Grok CLI has access to models **not available** on the public `api.x.ai` API yet:
 
 | Model | Public API (`api.x.ai`) | Grok CLI |
 |---|---|---|
@@ -18,6 +15,16 @@ The Grok CLI uhas access to models **not available** on the public `api.x.ai` AP
 
 `grok-composer-2.5-fast` is Cursor's Composer 2.5 model, a purpose-built agentic coding model optimized for long-horizon coding tasks.
 
+## Cursor Tool Compatibility
+
+Grok CLI models are trained to use Cursor-style coding tools. This extension includes compatibility shims so those models can keep using familiar tool calls inside pi:
+
+- File tools: `Read`, `Write`, `StrReplace`, `Edit`, `Delete`, and `LS`
+- Search tools: `Grep` and `Glob`
+- Terminal tool: `Shell`
+
+The shims also normalize common Cursor/Grok argument shapes, such as `contents` for writes, `glob_pattern` for file search, `glob_filter` for grep filters, and `old_string`/`new_string` or `oldText`/`newText` for exact replacements. This keeps agentic coding workflows moving instead of failing on tool schema mismatches.
+
 ## Requirements
 
 You need an active Grok subscription or an X Premium subscription with Grok access to use this extension.
@@ -66,4 +73,4 @@ Select **"Grok CLI"** from the provider list. This opens the xAI OAuth page in y
 | `PI_GROK_CLI_MODELS` | (all models) | Comma-separated model IDs to expose |
 | `PI_GROK_CLI_OAUTH_CLIENT_ID` | `b1a00492-...` | Override OAuth client ID |
 | `PI_GROK_CLI_OAUTH_SCOPE` | `openid profile email offline_access grok-cli:access api:access` | Override OAuth scopes |
-| `GROK_CLI_OAUTH_TOKEN` | — | Direct token bypass (no auto-refresh) |
+| `GROK_CLI_OAUTH_TOKEN` | — | Direct token bypass that skips OAuth entirely. No automatic refresh or renewal is performed; provide a valid external access token and replace or rotate it when it expires. |

biome.json

@@ -1,34 +1,38 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
-	"vcs": {
-		"enabled": true,
-		"clientKind": "git",
-		"useIgnoreFile": true
-	},
-	"files": {
-		"ignoreUnknown": false
-	},
-	"formatter": {
-		"enabled": true,
-		"indentStyle": "tab"
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true
-		}
-	},
-	"javascript": {
-		"formatter": {
-			"quoteStyle": "double"
-		}
-	},
-	"assist": {
-		"enabled": true,
-		"actions": {
-			"source": {
-				"organizeImports": "on"
-			}
-		}
-	}
+  "$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "trailingCommas": "all",
+      "semicolons": "always"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
 }

knip.json

@@ -1,5 +1,5 @@
 {
-	"entry": ["src/shared/backup_worker.ts"],
-	"project": ["**/*.ts", "!**/*.d.ts", "!.release-tools/**"],
-	"ignoreDependencies": ["lint-staged"]
+  "entry": ["src/shared/backup_worker.ts"],
+  "project": ["**/*.ts", "!**/*.d.ts", "!.release-tools/**"],
+  "ignoreDependencies": ["lint-staged"]
 }

package.json

@@ -1,74 +1,76 @@
 {
-	"name": "pi-grok-cli",
-	"version": "0.1.1",
-	"description": "Use Grok CLI's API endpoint in pi.",
-	"keywords": [
-		"pi-package",
-		"pi-extension",
-		"xai",
-		"grok",
-		"grok-cli",
-		"oauth",
-		"xai-oauth"
-	],
-	"type": "module",
-	"main": "./src/index.ts",
-	"files": [
-		"README.md",
-		"src",
-		"tsconfig.json"
-	],
-	"scripts": {
-		"test": "vitest run --reporter=agent",
-		"coverage": "vitest run --reporter=agent --coverage",
-		"typecheck": "tsc --noEmit",
-		"prepack": "bun run test && bun run coverage && bun run typecheck",
-		"knip": "knip --production",
-		"lint": "biome check --write .",
-		"lint:ci": "biome ci .",
-		"check": "bun run lint && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
-		"check:ci": "bun run lint:ci && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
-		"prepare": "husky",
-		"check-duplicates": "bunx jscpd src tests --exitCode 1 --reporters ai --noTips"
-	},
-	"author": {
-		"name": "J Liew",
-		"email": "jliew@420024lab.com"
-	},
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/kenryu42/pi-grok-cli.git"
-	},
-	"bugs": {
-		"url": "https://github.com/kenryu42/pi-grok-cli/issues"
-	},
-	"homepage": "https://github.com/kenryu42/pi-grok-cli#readme",
-	"pi": {
-		"extensions": [
-			"./src/index.ts"
-		]
-	},
-	"peerDependencies": {
-		"@earendil-works/pi-ai": "*",
-		"@earendil-works/pi-coding-agent": "*"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.4.16",
-		"@earendil-works/pi-ai": "^0.78.0",
-		"@earendil-works/pi-coding-agent": "^0.78.0",
-		"@vitest/coverage-v8": "^4.1.8",
-		"husky": "^9.1.7",
-		"jscpd": "^4.2.4",
-		"knip": "^6.15.0",
-		"lint-staged": "^17.0.7",
-		"release-tools": "github:kenryu42/release-tools",
-		"typescript": "^6.0.3",
-		"vitest": "^4.1.8"
-	},
-	"lint-staged": {
-		"*": [
-			"biome check --write --no-errors-on-unmatched"
-		]
-	}
+  "name": "pi-grok-cli",
+  "version": "0.1.1",
+  "description": "Use Grok CLI's API endpoint in pi.",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "xai",
+    "grok",
+    "grok-cli",
+    "oauth",
+    "xai-oauth"
+  ],
+  "type": "module",
+  "main": "./src/index.ts",
+  "files": [
+    "README.md",
+    "src",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "test": "vitest run --reporter=agent",
+    "coverage": "vitest run --reporter=agent --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepack": "bun run test && bun run coverage && bun run typecheck",
+    "knip": "knip --production",
+    "lint": "biome check --write .",
+    "lint:ci": "biome ci .",
+    "check": "bun run lint && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
+    "check:ci": "bun run lint:ci && bun run typecheck && bun run knip && bun run check-duplicates && AGENT=1 bun run coverage",
+    "prepare": "husky",
+    "check-duplicates": "bunx jscpd src tests --exitCode 1 --reporters ai --noTips"
+  },
+  "author": {
+    "name": "J Liew",
+    "email": "jliew@420024lab.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kenryu42/pi-grok-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kenryu42/pi-grok-cli/issues"
+  },
+  "homepage": "https://github.com/kenryu42/pi-grok-cli#readme",
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.16",
+    "@earendil-works/pi-ai": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "^0.78.0",
+    "@earendil-works/pi-tui": "^0.78.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "husky": "^9.1.7",
+    "jscpd": "^4.2.4",
+    "knip": "^6.15.0",
+    "lint-staged": "^17.0.7",
+    "release-tools": "github:kenryu42/release-tools",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "lint-staged": {
+    "*": [
+      "biome check --write --no-errors-on-unmatched"
+    ]
+  }
 }