docs: OSC 8 hyperlinks, Codex Warp plugin, and context window usage breakdown - #451
Conversation
…w breakdown Fills three GA feature gaps surfaced by a missing-docs audit against warp-internal: - Files, links, & scripts: OSC 8 hyperlink support (Cmd/Ctrl+click, copy behavior, any URL scheme), which was undocumented. - Codex: replace the stale `notification_condition = "always"` setup with the Warp plugin flow (install/update chip, `codex plugin marketplace add warpdotdev/codex-warp`, `codex plugin add warp@codex-warp`), which is how notifications work now. - Interacting with agents: the per-segment context window usage breakdown in the conversation usage card, including what each segment means and how to use it to decide what to trim. Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
![oz-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
There was a problem hiding this comment.
Overview
This PR updates docs for Codex plugin notifications, context window usage breakdowns, and OSC 8 hyperlinks. The Codex plugin commands and OSC 8 behavior line up with the local source context, and no security or spec-drift findings apply because the diff is documentation-only and the supplied spec context says none was found.
Concerns
- The context window breakdown instructions point users at the row itself, but the implementation exposes a
View breakdowntoggle inside that row.
Verdict
Found: 0 critical, 1 important, 0 suggestions
Request changes
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
Co-authored-by: oz-for-oss[bot] <277970191+oz-for-oss[bot]@users.noreply.github.com>
…n-context-breakdown
Co-Authored-By: Warp Agent <agent@warp.dev>
2 participants
Summary
Ran the
missing_docsaudit (feature-flag coverage againstwarp-internal) and fixed the gaps that are still real in this repo. The audit flagged 23 GA feature flags with no doc coverage; most are already documented here (tab groups and pinned tabs, prompt queueing, custom routers, runners, handoff, Gemini Enterprise, agent API keys) or are internal-only. Three were genuine gaps:OscHyperlinks) — completely undocumented. Adds a section to Files, links, & scripts covering how Warp renders an OSC 8 link, the⌘/Ctrl+click behavior, copy behavior, supported schemes, and aprintfexample to try it.CodexPlugin) — the Codex page still told users to setnotification_condition = "always"in~/.codex/config.toml. That's the fallback path; notifications now come from thewarp@codex-warpplugin. Replaces the setup steps with the install/update chip flow and the equivalentcodex plugincommands, and updates the corresponding bullet in Supported Warp features.ContextWindowUsageBreakdown) — adds a subsection to Interacting with agents describing the expandable per-segment breakdown on the Context window used row (System Prompt, Tool Definitions, Conversation History, Latest Input, Images, Other) and how to act on it.Verification
warp-internal: the OSC 8 parser and integration tests (crates/integration/src/test/osc8_hyperlinks.rs),CodexPluginManagerinstall/update instructions (app/src/terminal/cli_agent_sessions/plugin_manager/codex.rs), and the usage-card breakdown rendering (app/src/ai/blocklist/usage/conversation_usage_view.rs).python3 .agents/skills/check_for_broken_links/check_links.py --internal-only— 3309 internal links checked, 0 broken.python3 .agents/skills/style_lint/style_lint.py --all— no new issues on the edited pages (remaining warnings are pre-existing).Note
The audit skill is also present in the archived
warpdotdev/gitbookrepo, which can no longer accept pushes. Its surface map is out of date relative to this repo, so future audits should be run from here.Conversation: https://app.warp.dev/conversation/edaec245-26a9-489a-ae8c-7ba61494c5f0
Run: https://oz.warp.dev/runs/019fc6da-05a1-7494-9a18-7cc22bb9e671
This PR was generated with Oz.