Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Windows local-file Markdown links fail on Ctrl+click when the assistant emits drive-letter paths

Open
#4,885 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
52/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
markdown, powershell

Research direction

Start with the structural Markdown renderer and the CLI openLink helper, then reproduce the drive-letter link in a local Windows Terminal session while capturing the emitted hyperlink target. Compare Ctrl+click and Ctrl+X then O for Windows paths and file URIs, including the listed special characters and path forms. Done means supported local files open reliably without weakening protocol or hostname restrictions, with regression coverage for the reproduced cases.

Written by the indexing model from the issue text.

Description

triage
Describe the bug

Environment

  • GitHub Copilot CLI 1.0.84-6, Windows x64
  • Windows Terminal 1.24.260710001
  • PowerShell 7.6.6
  • Windows build 26200.9448 / 25H2
  • Local Windows Terminal session; WT_SESSION is present

Problem
Copilot creates an existing local HTML report and returns a Markdown link targeting an absolute Windows filesystem path. Ctrl+click does not open the report. The user has encountered this repeatedly.

Reproduction

  1. Create C:\Temp\copilot-link-repro\report.html.
  2. Have Copilot render this exact Markdown:
    Open report
  3. Ctrl+click "Open report".
  4. Compare these controls:
    Open report
    HTTPS control
  5. Also compare Ctrl+X, then O ("open most recent link").

Expected
Assistant-generated local-file links open the existing file using its default application. Supported Windows paths are converted to properly escaped file URIs before rendering and opening.

Actual
The reported drive-letter link does not open the file. File existence was verified. The exact terminal click payload/error was not captured.

Diagnostic evidence

  • The installed structural Markdown renderer passes the parsed href directly:
    link: { url: r.href, id: d5(r.href) }
  • d5 computes a link ID, not path normalization.
  • The CLI openLink helper allows http:, https:, and local file: URLs.
  • URL parsing treats C:... as protocol "c:", not "file:".
  • An isolated test of the installed opener, with a stub launcher, showed:
    C:... -> rejected; launcher not called
    file:///C:/... -> accepted; launcher called
    https://example.com -> accepted; launcher called

Qualification
This confirms a Windows path/URI handling gap. It does not establish that Ctrl+click invokes the CLI opener; Windows Terminal can dispatch OSC 8 hyperlinks itself. Capture the emitted hyperlink target and compare the controls to locate the click-specific failure.

Suggested fix
Emit canonical file URIs for local artifacts and normalize supported Windows absolute paths before rendering/opening. Preserve protocol and hostname restrictions rather than allowing arbitrary schemes. Surface an actionable error instead of silent failure.

Regression coverage
Test Ctrl+click and Ctrl+X then O with drive-letter paths, canonical file URIs, .copilot-style directories, spaces, parentheses, #, %, Unicode, and long/wrapped labels.

In another session I got a link and asked:

What is the exact format of the link you just gave me? c:... or file:////c:/ ?

It was a Windows path in a Markdown link:

the link.md

try it again with file:// type lin

< new link that works >

Affected version

GitHub Copilot CLI 1.0.86-0

Steps to reproduce the behavior

See above.

Expected behavior

Clickable link

Additional context

No response

Dominant language
Shell
Stars
11.2k
Forks
1.9k
Avg merge
14h 16m
Merged PRs (30d)
6

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/copilot-cli

All issues in github/copilot-cli

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.