Skip to content

[issues/529] Add Gemini Code Assist as built-in AI assistant destination #538

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
couimet wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[issues/529] Add Gemini Code Assist as built-in AI assistant destination #538

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions packages/rangelink-vscode-extension/.vscode-test.with-extensions.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ import { defineConfig } from '@vscode/test-cli';
import { ASSISTED_TIMEOUT_MS, BASE_CONFIG, userDataDir } from './.vscode-test.base.mjs';

// Marketplace extensions installed before tests run. With these present,
// isClaudeCodeAvailable() returns true, enabling tests that verify real
// focus + paste behavior.
const MARKETPLACE_EXTENSIONS = ['anthropic.claude-code'];
// isGeminiCodeAssistAvailable() and isClaudeCodeAvailable() return true,
// enabling tests that verify real focus + paste behavior.
const MARKETPLACE_EXTENSIONS = ['google.geminicodeassist', 'anthropic.claude-code'];

export default defineConfig([
{
Expand Down
10 changes: 7 additions & 3 deletions packages/rangelink-vscode-extension/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,12 +35,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- When more open files exist beyond the inline list, extras collapse into "More files..." which opens a secondary picker
- Secondary picker organizes all open files into "Active Files" section + per-"Tab Group N" sections
- Escaping the secondary picker returns to the destination picker
- **Gemini Code Assist Integration** - Paste destination for Google's Gemini Code Assist (#529) <sup>Unreleased</sup>
- Automatically inserts links and selected text directly into Gemini Code Assist
- Requires [Gemini Code Assist](https://marketplace.visualstudio.com/items?itemName=Google.geminicodeassist) extension (`Google.geminicodeassist`)
- Configurable cold-start timing: `rangelink.destinations.gemini.coldStartDelayMs` (default: `2500`) and `rangelink.destinations.gemini.coldRefocusIntervalMs` (default: `300`) — tune for your machine's speed; increase the delay on slower hardware if the initial paste after binding silently fails to reach the Gemini panel
- **Custom AI Assistants** - Connect RangeLink to any AI tool with a VS Code extension (#500) <sup>Unreleased</sup>
- New setting `rangelink.customAiAssistants`: three-tier command schema — `insertCommands` (direct text delivery), `focusAndPasteCommands` (focus + auto-paste), `focusCommands` (focus + manual paste toast)
- Custom assistants appear in the destination picker (R-D) alongside built-in destinations
- Lazy tier resolution: RangeLink checks which commands are registered on first use and caches the winning tier — no per-operation overhead
- Override built-in assistants (Cursor, Claude Code, Copilot) via config with automatic fallback to hardcoded commands
- `${content}` template interpolation for insert commands with non-standard argument formats
- **Claude Code Cold-Start Timing** - Configurable cold-start settings for the Claude Code Extension destination <sup>Unreleased</sup>
- `rangelink.destinations.claudeCode.coldStartDelayMs` (default: `2500`) and `rangelink.destinations.claudeCode.coldRefocusIntervalMs` (default: `300`) — tune for your machine's speed; increase the delay on slower hardware if the initial paste after binding silently fails to reach the Claude Code panel
- **Release Notifier** - Once-per-upgrade notification so new versions don't go unnoticed (#525)
- On upgrade, shows "RangeLink updated to vX.Y.Z. See what changed!" with "What's New" and "Skip for this version" buttons
- "What's New" opens the GitHub releases page; "Skip for this version" silences without opening the browser
Expand Down Expand Up @@ -116,9 +122,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- **Forgiving filename navigation** - Links with bare filenames (no directory path) now navigate when exactly one matching file exists in the workspace (#342)
- Covers links generated by AI tools that omit directory prefixes (e.g., `RangeLinkNavigationHandler.ts#L10`)
- When the filename is ambiguous (multiple matches) or not found, the existing "Cannot find file" warning is shown
- **Claude Code cold-start re-focus loop** - Adds configurable `coldStartDelayMs` and `coldRefocusIntervalMs` settings under `rangelink.destinations.claudeCode.*` to ensure the chat panel is ready before the first paste dispatch after binding.

<!-- TODO: #366 unhide when bookmarks graduate from beta — re-add these entries to the sections above
<!-- TODO: #366 unhide when bookmarks graduate from beta — re-add these entries to the sections above
- R-M menu: add "List Bookmarks / Manage Bookmarks" bullet
- Editor Content context menu: add "RangeLink: Save Selection as Bookmark" row
- **Bookmarks System** - Save code locations for quick access later
Expand Down
44 changes: 29 additions & 15 deletions packages/rangelink-vscode-extension/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@ Every AI coding assistant has its own way to share code — different shortcuts,

**RangeLink unifies it:**

- **One keybinding** — `Cmd+R Cmd+L` works with Claude, Copilot, Cursor, terminal tools, text editors. Learn once, use everywhere.
- **One keybinding** — `Cmd+R Cmd+L` works with Claude Code, Gemini Code Assist, Copilot, Cursor, terminal tools, text editors. Learn once, use everywhere.
- **Better precision** — Character-level ranges, not just lines. Share exactly what matters.
- **Universal format** — GitHub-style links work in PRs, Slack, docs. Not proprietary.
- **AI-agnostic** — Your workflow doesn't change when you switch AI assistants. Bring your own AI tool — if it has a VS Code extension with a focus command, RangeLink can paste into it.
- **AI-agnostic** — Your workflow doesn't change when you switch AI tools. Bring your own — if it has a VS Code extension with a focus command, or runs in a terminal, RangeLink can paste into it.

### For AI-Assisted Development

**Using Claude Code, Cursor, Copilot, or any other AI tool?** RangeLink eliminates the context-sharing friction:
**Using Claude Code, Gemini Code Assist, Cursor, Copilot, or any other AI tool — in an extension or terminal?** RangeLink eliminates the context-sharing friction:

1. **Select code** → Generate link (`Cmd+R Cmd+L`)
2. **Destination handles delivery** → Link appears where your AI can see it
Expand All @@ -38,14 +38,15 @@ Every AI coding assistant has its own way to share code — different shortcuts,
**Compete with built-in AI features** by making external AI assistants feel integrated. You get:

- ⚡ **Zero-friction AI context** — Destinations auto-send links. No clipboard juggling.
- 🎯 **Choice of AI model** — Claude, GPT, Gemini, anything. Not locked into one vendor.
- 🎯 **Choice of AI tool** — Claude Code, Gemini Code Assist, Copilot, Cursor, terminal CLI tools, anything. Not locked into one vendor or one interface.
- 📐 **Full control over context** — Character-level precision (`#L42C10`), not just line-level.
- 🔗 **Cross-file context** — Generate links from multiple files, paste all in one prompt.
- 🌐 **Universal compatibility** — Works across editors (VSCode, Cursor) and in any text-based tool.

### Perfect For

- 🤖 **AI assistants** — Claude Code Extension, Cursor AI, terminal claude-code, Copilot, plus any custom AI tool via settings <sup>Unreleased</sup> — with _exact_ context + clickable navigation
- 🤖 **AI assistants** — Claude Code (extension or terminal), Gemini Code Assist, Cursor AI, Copilot, plus any custom AI tool via settings <sup>Unreleased</sup> — with _exact_ context + clickable navigation
- 💻 **Terminal AI tools** — Claude Code CLI, gemini-cli, or any terminal-based AI workflow — links paste at your cursor and the terminal auto-focuses
- 💬 **Code reviews** — "The bug is in `api/routes.ts#L215C8-L223C45`" (click to view)
- 👥 **Team collaboration** — Universal format everyone can use and navigate

Expand Down Expand Up @@ -146,6 +147,7 @@ When you close the bound file, RangeLink auto-unbinds with a notification. If th
**Built-in AI assistants:**

- **[Claude Code Extension](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)** — Anthropic's official extension (works in VSCode and Cursor)
- **[Gemini Code Assist](https://marketplace.visualstudio.com/items?itemName=Google.geminicodeassist)** — Google's AI coding assistant
- **Cursor AI** — Built into Cursor IDE
- **[GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)** — GitHub's AI coding assistant
Comment thread
coderabbitai[bot] marked this conversation as resolved.

Expand All @@ -157,7 +159,7 @@ When you close the bound file, RangeLink auto-unbinds with a notification. If th
2. Select code → `Cmd+R Cmd+L` → Link auto-pastes into chat
3. Review and send

**One destination at a time:** Bind to Claude Code, Cursor AI, a custom AI tool, terminal, OR text editor. **Quick switching:** Run a different "Bind to..." command or use the R-D picker to replace your current binding with confirmation—no need to unbind first.
**One destination at a time:** Bind to Claude Code, Gemini Code Assist, Cursor AI, a custom AI tool, terminal, OR text editor. **Quick switching:** Run a different "Bind to..." command or use the R-D picker to replace your current binding with confirmation—no need to unbind first.

---

Expand Down Expand Up @@ -283,6 +285,7 @@ Access via `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux), then type "Ran
| Send Current File Path (Absolute) <sup>Unreleased</sup> | `Cmd+R Cmd+Shift+F` | `Ctrl+R Ctrl+Shift+F` | Send active editor's absolute path to bound destination |
| Bind to Destination <sup>Unreleased</sup> | `Cmd+R Cmd+D` | `Ctrl+R Ctrl+D` | Open destination picker to select and bind a target |
| Bind to Claude Code | — | — | Auto-send links to Claude Code chat |
| Bind to Gemini Code Assist <sup>Unreleased</sup> | — | — | Auto-send links to Gemini Code Assist chat |
| Bind to Cursor AI | — | — | Auto-send links to Cursor AI chat |
| Bind to GitHub Copilot Chat | — | — | Auto-send links to Copilot Chat |
| Bind to Terminal | — | — | Auto-send links to integrated terminal for AI workflows |
Expand Down Expand Up @@ -368,7 +371,7 @@ Customize settings in VSCode (Preferences > Settings > search "rangelink").
| ------------------------------ | ------- | ---------------------------------------------------- |
| `rangelink.customAiAssistants` | `[]` | Array of custom AI assistant definitions (see below) |

Define custom AI assistants to extend RangeLink beyond the three built-in AI tools. Each entry has two required fields and three optional command arrays:
Define custom AI assistants to extend RangeLink beyond the four built-in AI tools. Each entry has two required fields and three optional command arrays:

| Field | Type | Required | Description |
| ----------------------- | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Expand Down Expand Up @@ -411,7 +414,7 @@ At least one of the three command arrays must be present. RangeLink tries them i

When `sparkAi.insertText` is registered (extension supports it), RangeLink uses direct insertion — no clipboard involved. If the command isn't available (older extension version), RangeLink falls back to the focus + manual paste flow automatically.

**Overriding built-in assistants:** <sup>Unreleased</sup> You can customize the built-in AI assistants (Cursor, Claude Code, Copilot) by adding an entry with the same `extensionId`. RangeLink merges your custom tiers with the built-in's hardcoded commands as a safety-net fallback. If your custom commands aren't registered (typo, extension not updated), the built-in behavior takes over automatically.
**Overriding built-in assistants:** <sup>Unreleased</sup> You can customize the built-in AI assistants (Claude Code, Gemini Code Assist, Cursor, Copilot) by adding an entry with the same `extensionId`. RangeLink merges your custom tiers with the built-in's hardcoded commands as a safety-net fallback. If your custom commands aren't registered (typo, extension not updated), the built-in behavior takes over automatically.

```json
{
Expand Down Expand Up @@ -444,6 +447,24 @@ Here `insertCommands` is tried first (Tier 1). If `myPlugin.sendToCopilot` isn't

Run **Developer: Reload Window** (or restart VS Code) after changing this setting.

### Destination Settings — Claude Code <sup>Unreleased</sup>

| Setting | Default | Description |
| --------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------- |
| `rangelink.destinations.claudeCode.coldStartDelayMs` | `1500` | Total duration (ms) RangeLink waits for the Claude Code panel to become ready on first use |
| `rangelink.destinations.claudeCode.coldRefocusIntervalMs` | `300` | Interval (ms) at which RangeLink re-sends the Claude Code focus signal during the cold-start wait |

On first use after binding, the Claude Code chat panel needs time to initialize. During the cold-start period, RangeLink periodically re-focuses the panel so it receives keyboard focus once ready. After the first successful paste, subsequent operations use a faster warm-start path. Increase `coldStartDelayMs` on slower machines; decrease `coldRefocusIntervalMs` for more aggressive re-focusing. `coldStartDelayMs` must be greater than `coldRefocusIntervalMs` — if violated, defaults are used.

### Destination Settings — Gemini Code Assist <sup>Unreleased</sup>

| Setting | Default | Description |
| ----------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------- |
| `rangelink.destinations.gemini.coldStartDelayMs` | `2500` | Total duration (ms) RangeLink waits for the Gemini panel to become ready on first use |
| `rangelink.destinations.gemini.coldRefocusIntervalMs` | `300` | Interval (ms) at which RangeLink re-sends the Gemini focus signal during the cold-start wait |

On first use after binding, Gemini Code Assist's webview panel needs time to initialize. During the cold-start period, RangeLink periodically re-focuses the panel so it receives keyboard focus once ready. After the first successful paste, subsequent operations use a faster warm-start path. Increase `coldStartDelayMs` on slower machines; decrease `coldRefocusIntervalMs` for more aggressive re-focusing. `coldStartDelayMs` must be greater than `coldRefocusIntervalMs` — if violated, defaults are used.

### Clipboard Settings <sup>Unreleased</sup>

| Setting | Default | Description |
Expand Down Expand Up @@ -491,13 +512,6 @@ Set the navigation settings to `false` for a quieter workflow. Navigation itself

When you have more terminals than this threshold, the destination picker shows a "More terminals..." option instead of listing all terminals individually.

### Claude Code Settings <sup>Unreleased</sup>

| Setting | Default | Description |
| --------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------ |
| `rangelink.destinations.claudeCode.coldStartDelayMs` | `1500` | Total duration (ms) of the cold-start re-focus window for Claude Code |
| `rangelink.destinations.claudeCode.coldRefocusIntervalMs` | `300` | Interval (ms) between successive focus-command re-sends during the cold-start window |

### Delimiter Settings

| Setting | Default | Description |
Expand Down
20 changes: 20 additions & 0 deletions packages/rangelink-vscode-extension/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,12 @@
"category": "RangeLink",
"icon": "$(link)"
},
{
"command": "rangelink.bindToGeminiCodeAssist",
"title": "Bind to Gemini Code Assist",
"category": "RangeLink",
"icon": "$(link)"
},
{
"command": "rangelink.bindToGitHubCopilotChat",
"title": "Bind to GitHub Copilot Chat",
Expand Down Expand Up @@ -548,6 +554,20 @@
"description": "Interval (ms) between successive focus-command re-sends during the Claude Code cold-start window.",
"title": "Claude Code Cold Re-focus Interval"
},
"rangelink.destinations.gemini.coldStartDelayMs": {
"type": "number",
"default": 2500,
"minimum": 500,
"maximum": 15000,
"description": "Total duration (ms) RangeLink waits for the Gemini panel to become ready on first use, sending periodic refocus signals. Increase on slower machines if automatic paste does not work. Must be greater than coldRefocusIntervalMs."
},
"rangelink.destinations.gemini.coldRefocusIntervalMs": {
"type": "number",
"default": 300,
"minimum": 100,
"maximum": 5000,
"description": "Interval (ms) at which RangeLink re-sends the Gemini focus signal during the cold-start period. Must be less than coldStartDelayMs."
},
"rangelink.features.bookmarks.enabled": {
"type": "boolean",
"default": false,
Expand Down
Loading
Loading