Custom URL scheme links are rewritten to app://-/index.html?hostId=local

Open 💬 2 comments Opened Apr 17, 2026 by nannestad

What version of the Codex App are you using (From “About Codex” dialog)?

26.415.21839 (1763)

What subscription do you have?

Business

What platform is your computer?

macOS

What issue are you seeing?

Markdown links using a custom URL scheme are not preserved correctly in the Codex desktop app. When a response contains a link using the linear:// scheme, Codex appears to rewrite it through its own local wrapper instead of preserving the original deep link. That breaks the intended behavior and prevents the link from opening the target desktop app.

What steps can reproduce the bug?

  1. Render or output a Markdown link in Codex using a Linear deep link, for example:

[FRI-706: Introduce Wallet as the source of truth for payment methods](linear://linear.app/digital-fireworks/issue/FRI-706/introduce-wallet-as-the-source-of-truth-for-payment-methods)

  1. Click the link in the Codex desktop app, or copy the link target from the rendered response.
  2. Observe that the link is not treated as the original linear://... URL and instead gets rewritten through the Codex app wrapper.

What is the expected behavior?

The rendered link should preserve the original deep link target exactly as written. In the example above, clicking the link should open the Linear desktop app directly to the issue:

linear://linear.app/digital-fireworks/issue/FRI-706/introduce-wallet-as-the-source-of-truth-for-payment-methods

It should not be rewritten through another scheme or local wrapper.

Additional information

When copied from the Codex UI, the link appears as:

app://-/index.html?hostId=local

That suggests Codex is intercepting and rewriting custom URL scheme links instead of preserving them. This makes custom app deep links unusable from Codex responses. I reproduced this with a linear:// link, but the issue may apply to other custom URL schemes as well.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗