Skip to content

vscode: TerminalLinkProvider — make #N / PR #N references in terminals clickable (issue viewer / browser) #1412

Description

@amrmelsayed

Problem

Architect and builder terminal output constantly references issues and PRs by number (#915, PR #1402). In VS Code terminals these are not actionable: Cmd+click falls through to VS Code's workspace word search, which matches nothing and silently does nothing. Every reference costs a manual lookup.

Fix

Register a vscode.window.registerTerminalLinkProvider in the extension that claims #\d+ and PR #\d+ spans in all terminal lines and makes them Cmd+clickable. Claiming the span also stops VS Code's useless fallback search.

Click resolution (decided with the owner, 2026-08-12)

Scope

  • New file in apps/vscode/src/ (link provider + resolution), registered in extension.ts — the open-pr-by-id.ts / open-issue-by-id.ts pattern and their fetch paths are the template; reuse openIssueInBrowser/openPRInBrowser/viewBacklogIssue rather than new fetch code.
  • Tests: link detection (line-scan spans incl. multiple refs per line), resolution order (issue-first, PR fallback), setting behavior.

Out of scope (follow-up)

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/vscodeArea: VS Code extension

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions