@greppleai/grip 0.1.4 → 0.1.5

package/dist/utils/grip-user-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grip-user-agent.d.ts","sourceRoot":"","sources":["../../src/utils/grip-user-agent.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD","sourcesContent":["export function getGripUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `pi/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}
+{"version":3,"file":"grip-user-agent.d.ts","sourceRoot":"","sources":["../../src/utils/grip-user-agent.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD","sourcesContent":["export function getGripUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `grip/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}

package/dist/utils/grip-user-agent.js

@@ -1,5 +1,5 @@
 export function getGripUserAgent(version) {
     const runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;
-    return `pi/${version} (${process.platform}; ${runtime}; ${process.arch})`;
+    return `grip/${version} (${process.platform}; ${runtime}; ${process.arch})`;
 }
 //# sourceMappingURL=grip-user-agent.js.map

package/dist/utils/grip-user-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"grip-user-agent.js","sourceRoot":"","sources":["../../src/utils/grip-user-agent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAU;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;IACjG,OAAO,MAAM,OAAO,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC;AAAA,CAC1E","sourcesContent":["export function getGripUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `pi/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}
+{"version":3,"file":"grip-user-agent.js","sourceRoot":"","sources":["../../src/utils/grip-user-agent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAU;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;IACjG,OAAO,QAAQ,OAAO,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC;AAAA,CAC5E","sourcesContent":["export function getGripUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `grip/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}

package/docs/keybindings.md

@@ -140,12 +140,14 @@ This routing remains configurable through the ordinary action bindings. For exam
 
 | Keybinding id | Default | Description |
 |--------|---------|-------------|
-| `app.model.select` | `ctrl+l` | Open model selector |
+| `app.model.select` | `ctrl+l` | Open provider-first model selector |
 | `app.model.cycleForward` | `ctrl+p` | Cycle to next model |
 | `app.model.cycleBackward` | `shift+ctrl+p` | Cycle to previous model |
 | `app.thinking.cycle` | `shift+tab` | Cycle thinking level |
 | `app.thinking.toggle` | `ctrl+t` | Collapse or expand thinking blocks |
 
+The model selector uses `tui.select.up` / `down`, `tui.select.pageUp` / `pageDown`, `tui.select.confirm`, and `tui.select.cancel`. `tui.input.tab` switches scoped/all models when a scope exists. Its hints follow these bindings. See [Model Selection](usage.md#model-selection) for navigation and restoring `app.model.select` after disabling a picker extension.
+
 ### Display and Message Queue
 
 | Keybinding id | Default | Description |

package/docs/providers.md

@@ -59,7 +59,7 @@ grip
 | Cloudflare AI Gateway | `CLOUDFLARE_API_KEY` (+ `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_GATEWAY_ID`) | `cloudflare-ai-gateway` |
 | Cloudflare Workers AI | `CLOUDFLARE_API_KEY` (+ `CLOUDFLARE_ACCOUNT_ID`) | `cloudflare-workers-ai` |
 | xAI | `XAI_API_KEY` | `xai` |
-| OpenRouter | `OPENROUTER_API_KEY` | `openrouter` |
+| OpenRouter | `OPENROUTER_API_KEY` or `/login` → browser sign-in | `openrouter` |
 | Vercel AI Gateway | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway` |
 | ZAI | `ZAI_API_KEY` | `zai` |
 | OpenCode Zen | `OPENCODE_API_KEY` | `opencode` |
@@ -75,6 +75,8 @@ grip
 | Xiaomi MiMo Token Plan (Amsterdam) | `XIAOMI_TOKEN_PLAN_AMS_API_KEY` | `xiaomi-token-plan-ams` |
 | Xiaomi MiMo Token Plan (Singapore) | `XIAOMI_TOKEN_PLAN_SGP_API_KEY` | `xiaomi-token-plan-sgp` |
 
+OpenRouter browser sign-in (`/login` → Sign in (subscriptions or OpenRouter credits) → OpenRouter) uses PKCE to request a durable API key on your OpenRouter account. Requests are billed to your OpenRouter credits; this is **not** a subscription login and OpenRouter does not issue a refresh token. Grip stores the resulting key in `auth.json` as an API key. If it is revoked, sign in again. You can still paste an existing API key or set `OPENROUTER_API_KEY` instead.
+
 Reference for environment variables and `auth.json` keys: [`const envMap`](../../ai/src/env-api-keys.ts) in `packages/ai/src/env-api-keys.ts`.
 
 #### Auth File

package/docs/sandbox.md

@@ -69,7 +69,7 @@ The default Lima template name contains `docker-rootful`; it is a Lima VM templa
 
 ### Guest Grip during development
 
-A new managed VM installs an exact-version Linux Grip release using the checksummed repository installer, when those release assets are published. Existing named VMs must already provide Grip. To test local code, cross-compile a Linux binary matching the guest architecture and opt in:
+A new managed VM installs an exact-version Linux Grip release using the checksummed repository installer, when those release assets are published. An existing named per-session VM without Grip installs the latest published release using the same installer; an existing installation is left alone. In development, `GRIP_SANDBOX_GUEST_BINARY` installs the local Linux build instead, including in existing VMs. To test local code, cross-compile a Linux binary matching the guest architecture and opt in:
 
 ```bash
 NODE_OPTIONS=--import=tsx ./scripts/build-binaries.sh --skip-install --platform linux-x64

package/docs/usage.md

@@ -37,7 +37,7 @@ Type `/` in the editor to open command completion. Extensions can register custo
 | Command | Description |
 |---------|-------------|
 | `/login`, `/logout` | Manage OAuth or API-key credentials |
-| `/model` | Switch models |
+| `/model [reference or query]` | Choose a provider and model, select an exact reference, or search across providers |
 | `/scoped-models` | Enable/disable models for Ctrl+P cycling |
 | `/settings` | Thinking level, theme, message delivery, transport |
 | `/resume` | Pick from previous sessions |
@@ -61,6 +61,42 @@ Type `/` in the editor to open command completion. Extensions can register custo
 
 `/hooks` and `/sandbox` are user-only interactive commands hidden from model-visible command catalogs. `/sandbox` shows or clears the current backend, attaches a sandbox daemon, and manages local Docker sandbox containers; see [Workspace Sandbox](sandbox.md).
 
+## Model Selection
+
+Open `/model` or use `app.model.select` (Ctrl+L by default). The native picker **always starts with providers**, even when only one provider is available; it never skips straight to models.
+
+- Type to filter providers by display name or ID. Each row shows its ID, model count in the active scope, and a check mark for the current provider.
+- Use Up/Down or PageUp/PageDown to navigate. Enter opens the highlighted provider without changing the model or saved default.
+- In a provider, type to filter models by ID or readable name. Rows identify the provider, the current model has a check mark, and the highlighted model's readable name appears below the list. Enter selects the model and saves the primary model default.
+- Escape from models returns to providers and restores the previous provider filter and highlight. Reentering a provider starts with an empty model filter. Escape at the provider screen cancels without changing the model or default.
+- A nonempty filter edit selects the best match. Clearing a filter retains the selection's position where possible. Confirming an empty result does nothing.
+
+These are the default keys; selector hints follow your [keybindings](keybindings.md), including confirmation and cancellation.
+
+### Scoped and All Models
+
+If a model scope exists (configured with `/scoped-models`, `enabledModels`, or `--models`), the picker starts in **scoped** mode. Tab switches between scoped and all available models. Provider counts and membership reflect the active mode; a provider with no scoped models is absent until you switch to all.
+
+Switching scope in provider-first navigation returns to the provider screen and clears the filter. Models within a provider retain configured scoped order. In all mode, the current model comes first, followed by provider/model ID order. Providers are sorted by display name and ID. This is deterministic ordering, not newest-release ordering. Opening the picker refreshes the registry, including `models.json`; availability reflects configured authentication, not a live credential check.
+
+Model cycling (Ctrl+P / Shift+Ctrl+P) and `/scoped-models` configuration are unchanged. Choosing a model from all mode does not add it to your scope.
+
+### Direct References and Cross-provider Search
+
+- `/model provider/model-id` selects an exact available reference directly, without opening the picker. Exact matching respects the active model scope when one exists.
+- If the argument does not match an exact reference, `/model <query>` opens a model search across providers in the active scope. For example, `/model son` can find matching Sonnet models from multiple providers. Use Tab to include all available models when scoped mode is active.
+- In this cross-provider search, Tab keeps the query and search view; Escape cancels directly rather than opening providers. Clearing the query keeps the cross-provider model list. Bare `/model` always uses the provider-first flow.
+
+The `/compress-detection-model` picker uses the same provider-first navigation, but choosing a detector changes only its configuration, not the primary session model or primary default.
+
+### Migrating from provider-model-picker
+
+The native flow needs no extension, `/pm` command, or additional shortcut. Grip does not automatically disable your extension or rewrite personal configuration.
+
+1. Disable **every load source** for `provider-model-picker`. Use `grip config` to disable its resource in the applicable global or project scope, including auto-discovered local extensions. Remove any explicit `-e` / `--extension` launch argument or configured extension entry that still loads it. For a package, disable only the picker resource if you need its other resources; see [package filtering](packages.md#package-filtering). Removing an explicit entry alone is insufficient if the same extension is also auto-discovered.
+2. In `~/.grip/agent/keybindings.json`, check whether `app.model.select` was unbound with `[]`. Remove that override to inherit Ctrl+L, or merge `"app.model.select": "ctrl+l"` (or your preferred key) into the existing object. Keep unrelated bindings. Review any old extension shortcut overrides before removing them; do not unbind unrelated tree actions to free this key.
+3. Run `/reload`, or restart if you changed launch arguments. Verify `/model` and your configured model-selection shortcut both open Providers. `/pm` was extension-provided and is not a native command; use `/model` instead.
+
 ## Message Queue
 
 You can submit messages while the agent is still working:

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "grip-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "grip-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "grip-extension-sandbox",
 	"private": true,
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "grip-extension-with-deps",
 	"private": true,
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "@greppleai/grip",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@greppleai/grip",
-			"version": "0.1.4",
+			"version": "0.1.5",
 			"license": "MIT",
 			"dependencies": {
-				"@greppleai/grip-agent-core": "^0.1.4",
-				"@greppleai/grip-ai": "^0.1.4",
-				"@greppleai/grip-tui": "^0.1.4",
+				"@greppleai/grip-agent-core": "^0.1.5",
+				"@greppleai/grip-ai": "^0.1.5",
+				"@greppleai/grip-tui": "^0.1.5",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"chalk": "5.6.2",
 				"cross-spawn": "7.0.6",
@@ -502,11 +502,11 @@
 			"hasInstallScript": true
 		},
 		"node_modules/@greppleai/grip-agent-core": {
-			"version": "0.1.4",
-			"resolved": "https://registry.npmjs.org/@greppleai/grip-agent-core/-/grip-agent-core-0.1.4.tgz",
+			"version": "0.1.5",
+			"resolved": "https://registry.npmjs.org/@greppleai/grip-agent-core/-/grip-agent-core-0.1.5.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"@greppleai/grip-ai": "^0.1.4",
+				"@greppleai/grip-ai": "^0.1.5",
 				"ignore": "7.0.5",
 				"typebox": "1.3.7",
 				"yaml": "2.9.0"
@@ -516,8 +516,8 @@
 			}
 		},
 		"node_modules/@greppleai/grip-ai": {
-			"version": "0.1.4",
-			"resolved": "https://registry.npmjs.org/@greppleai/grip-ai/-/grip-ai-0.1.4.tgz",
+			"version": "0.1.5",
+			"resolved": "https://registry.npmjs.org/@greppleai/grip-ai/-/grip-ai-0.1.5.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.124.0",
@@ -540,8 +540,8 @@
 			}
 		},
 		"node_modules/@greppleai/grip-tui": {
-			"version": "0.1.4",
-			"resolved": "https://registry.npmjs.org/@greppleai/grip-tui/-/grip-tui-0.1.4.tgz",
+			"version": "0.1.5",
+			"resolved": "https://registry.npmjs.org/@greppleai/grip-tui/-/grip-tui-0.1.5.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@greppleai/grip",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"gripConfig": {
@@ -38,9 +38,9 @@
 		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap"
 	},
 	"dependencies": {
-		"@greppleai/grip-agent-core": "^0.1.4",
-		"@greppleai/grip-ai": "^0.1.4",
-		"@greppleai/grip-tui": "^0.1.4",
+		"@greppleai/grip-agent-core": "^0.1.5",
+		"@greppleai/grip-ai": "^0.1.5",
+		"@greppleai/grip-tui": "^0.1.5",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",