Skip to content

docs: document OSC 8 hyperlink support in the terminal - #455

Closed
hongyi-chen wants to merge 1 commit into
mainfrom
docs/osc8-hyperlinks
Closed

docs: document OSC 8 hyperlink support in the terminal#455
hongyi-chen wants to merge 1 commit into
mainfrom
docs/osc8-hyperlinks

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

What

Adds an OSC 8 hyperlinks section to terminal/more-features/files-and-links.mdx.

Why

Found by the missing_docs drift-watch audit: the OscHyperlinks feature flag was promoted
preview → GA (it is now in the default cargo feature set), but OSC 8 support had no docs
coverage anywhere on the site.

Source of truth

  • app/src/terminal/model/ansi/mod.rs — OSC 8 dispatch.
  • crates/warp_terminal/src/model/ansi/control_sequence_parameters.rsHyperlink::parse_osc_params,
    the 2083-byte URI cap, the 256-byte id cap, close-form handling, and ; rejoining.
  • app/src/terminal/view.rsopen_hyperlink_uri (URL-parse guard), and the Open link /
    Copy link context menu for GridHighlightedLink::Hyperlink.

Deferred findings from this run

Nothing from the audit was silently dropped. The full deferral list lives in the companion
bookkeeping PR (docs/missing-docs-audit-bookkeeping); in summary:

  • 15 warp-server public API routes missing from the OpenAPI spec — routed to the
    sync-openapi-spec skill rather than hand-written, per the skill's public/private guardrail.
  • 32 terminology/staleness findings — owned by the style_lint skill.
  • 1 new server-side agent tool (report_external_reference) — reached only through the hidden
    oz harness-support CLI, so no public surface to document yet.

Conversation: https://staging.warp.dev/conversation/c45bb2ea-d33b-4723-8249-478547f81a47
Run: https://oz.staging.warp.dev/runs/019fc891-7c04-779b-b006-328169d8a0d7

This PR was generated with Oz.

The OscHyperlinks feature flag was promoted preview -> GA, but Warp's OSC 8
hyperlink support was undocumented. Add an "OSC 8 hyperlinks" section to the
files, links, and scripts page covering how linked text behaves, how to emit
the sequence, and the parsing limits Warp enforces.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Aug 3, 2026
@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 3, 2026 5:21pm

Request Review

Copy link
Copy Markdown
Collaborator Author

Closing as a duplicate of #451, which already adds an OSC 8 hyperlinks section to this same page (terminal/more-features/files-and-links.mdx) and got there first.

Found while running the missing_docs drift-watch skill, which flagged OscHyperlinks as newly promoted preview → GA. I didn't check for existing open PRs before drafting — my mistake.

One note for #451: its other two files (agent-platform/cli-agents/codex.mdx and agent-platform/local-agents/interacting-with-agents/index.mdx) sit under the old agent-platform/ tree, which #420 renamed to agents/. Those paths will need rebasing onto the new locations before it can merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant