Deep links do not work when the URI is handled by an agent window
维护者通常 2 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 42/100
- Issue 类型
- 缺陷
- 描述清晰度
- 需要澄清
- 活跃度
- 活跃
- 技术栈
- typescript, vscode
调研方向
从 package.json 开始，检查 activation event 和 extension kind 元数据。在列出的 VS Code、Cursor、Devin 和 VSCodium 场景中复现 deep-link 行为，并检查 Cursor fix 是否已经发布。完成的标准是记录受影响的版本，并将 workaround 放入 README 或 Coder deep-link documentation，除非元数据提供了可行的更改。
由索引模型根据 Issue 内容生成。
描述
Summary
coder:// / vscode://coder.coder-remote/open?... deep links silently do nothing when the editor routes the URI to an "agent window" (VS Code Agents window, Cursor Agents window / Glass). These windows run a restricted extension host that does not load third-party extensions, so the extension is never activated and its registered vscode.window.registerUriHandler callback is never invoked.
The renderer logs the URI as handled, so no error is surfaced. The link appears to do nothing.
Reproduction (as reported for Cursor)
- Install
coder.coder-remote1.15.2. - Start Cursor 3.14.7 on Linux with a clean
HOMEand the default~/.cursor/extensionsdirectory. - Open
cursor://coder.coder-remote/open?workspace=test&url=https://coder.example.com. - Repeat after initialization completes.
Observed: renderer.log records the URI as handled, but extension-host initialization does not include coder.coder-remote, and there is no activation or URI-handler entry. On the repeat attempt, Cursor invokes workbench.extensions.installExtension even though the extension is already installed.
Expected: the installed extension is loaded and its onUri handler is invoked.
Upstream reports
- Cursor forum report and vendor response: https://forum.cursor.com/t/installed-extensions-onuri-handler-is-not-invoked-for-custom-uri/167316
- Cursor confirmed this is a known issue in 3.14.7:
cursor://links for third-party extensions can be handled in the Agents window, where the extension does not load, soonUridoes not fire. A fix was said to be prepared. - Stated workaround: make a normal IDE window active before opening the link. If only the Agents window is open, open a new editor window first, then click the link again.
- Cursor confirmed this is a known issue in 3.14.7:
- Related Cursor reports about extensions not loading in the Agents window:
- VS Code has shipped its own Agents window
(https://code.visualstudio.com/docs/agents/run/agents-window), which has the same restricted extension host. Related upstream issues:- microsoft/vscode#315776 "Can extensions detect that they are running in the agents window"
- microsoft/vscode#315637 "Add a 'Enable in Agent window' in extensions view"
- microsoft/vscode#317460 "Agents Window: MCP server contributed by extension is not available"
Why this matters
Deep links are the primary entry point from the Coder dashboard ("Open in VS Code" / "Open in Cursor"). If the user's active or only window is an agent window, the flow fails with no feedback.
Scope
Tracking. The root cause is in the editor, not in this extension, so the work here is likely limited to:
- Confirming which editors and versions are affected (VS Code stable/insiders, Cursor, Devin, VSCodium).
- Confirming whether the Cursor fix has shipped and in which version.
- Deciding whether to document the workaround in the README or in the Coder docs deep-link section.
- Investigating whether anything in
package.json(for example an explicitonUriactivation event, or extension kind metadata) changes whether the extension is loaded in these windows.
- 主要语言
- TypeScript
- 星标
- 131
- 派生
- 48
- 平均合并
- 2 天 3 小时
- 30 天内合并 PR
- 16
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
coder/vscode-coder 的其他 Issue
-
Improvement tech-debt vs-code
coder/vscode-coder#1135 · 1 条评论 ·
维护者通常 2 天内回复
-
Migrate CI setup to pnpm/setup可能已有人在做 @EhabY 于 17 天前认领。 未关闭tech-debt
coder/vscode-coder#1119 · 1 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
-
Design the VS Code Workspaces panel可能已有人在做 @chrifro 于 20 天前认领。 未关闭
coder/vscode-coder#1113 · 3 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
-
enhancement tech-debt
难度 5/5 一周以上 新手友好度 45/100
coder/vscode-coder#1112 · 1 条评论 ·
维护者通常 2 天内回复
-
Improvement tech-debt vs-code
难度 3/5 1-2 天 新手友好度 55/100
coder/vscode-coder#1066 · 2 条评论 ·
维护者通常 2 天内回复
查看 coder/vscode-coder 的全部 Issue
相似的 Issue
-
enhancement good first issue priority: low size: XS
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 88/100
-
难度 1/5 1 小时以内 新手友好度 90/100
streamplace/streamplace#1351 ·
维护者通常 2 天内回复
-
automated issue report
难度 2/5 1-3 小时 新手友好度 66/100
databendlabs/databend-docs#3511 ·
-
automated issue report
难度 2/5 1-3 小时 新手友好度 65/100