docs: Update Terminal Prompt documentation

[warp-agent-staging]

Summary

Updates the Terminal Appearance > Prompt page to match the current stable Warp prompt workflow. Removes obsolete right-click and same-line instructions, deletes stale media, and refreshes prompt compatibility guidance.

Changes

• Replaced obsolete prompt customization steps with the current Settings > Appearance > Input workflow.
• Clarified prompt context-menu behavior and current context-chip capabilities.
• Removed the stale prompt demo, editor screenshot, hidden same-line instructions, and outdated Powerlevel10k video.
• Corrected Starship, default-shell, minimum-contrast, and Powerlevel10k guidance.

Verification

• npm run build — passed.
• python3 .agents/skills/check_for_broken_links/check_links.py --internal-only — passed; 4,308 internal links checked.
• python3 .agents/skills/validate_ui_refs/validate_ui_refs.py --changed --require-provenance — passed; one changed file scanned with no issues.
• python3 .agents/skills/doc_quality_policy/check_compression_contract.py src/content/docs/terminal/appearance/prompt.mdx --content-type feature-doc — passed.
• python3 .agents/skills/style_lint/style_lint.py --changed — completed with three non-blocking glossary suggestions for verbatim UI labels: Appearance, Input, and Text.
• git diff --check origin/main...HEAD — passed.
• trunk check and trunk fmt — unavailable because Trunk is not installed in this environment.

Unverified claims

• Live visual verification was not possible: the stable Linux app confirmed its version but could not create a graphics surface. Prompt editor labels, Settings paths, and context-menu behavior were verified against the stable source cutoff and the committed UI-reference snapshot.
• Tide remains listed as unsupported for the current stable release. Its linked issue closed on 2026-10-02, after the 2026-09-30 stable release; confirm support in the next stable build.

Documentation risk

Risk: engineering-review-required
Rationale: Updates Prompt UI workflows, Settings labels, and shell prompt compatibility guidance.
Source files consulted: app/src/settings_view/appearance_page.rs, app/src/prompt/editor_modal.rs, app/src/terminal/view.rs, app/src/settings/select.rs, app/src/settings_view/features_page.rs@7cef787ea0e14073c907e7628ddb8d1a720222b5
Engineering review status: pending
Docs override: none

Additional context

• Slack request

Co-Authored-By: Oz oz-agent@warp.dev

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 5, 2026 12:12pm UTC

[warp-agent-staging]

This PR was generated with Warp.

Comment @warp-staging-factory on this PR to send it follow-up work.

  

[warp-for-oss]

@warp-agent-staging[bot]

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 /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[github-actions]

Review summary

The independent agent completed its review for this commit.

Findings

• src/content/docs/terminal/appearance/prompt.mdx:31 — [SUGGESTION] This step replaces the old right-click > Edit prompt flow, but src/content/docs/getting-started/quickstart/customizing-warp.mdx lines 17 and 36 still say to right-click the prompt area and select Edit prompt. Requested change: update those lines to the Settings > Appearance > Input path, or confirm the right-click entry point still exists.
• src/content/docs/terminal/appearance/prompt.mdx:132 — [SUGGESTION] The rewrite drops the earlier [custom] module / config-schema.json Starship error guidance and the fish-specific note without evidence they are obsolete. Requested change: confirm in the PR body that they no longer apply to the current stable build, or restore them.
• src/content/docs/terminal/appearance/prompt.mdx:136 — [SUGGESTION] The label Default shell for new sessions (previously "Startup shell for new sessions") and the new Shift+right-click claim at line 19 do not appear in the committed UI-reference snapshot. Requested change: add the specific source file and symbol for each to Source files consulted, or list them under Unverified claims.

Verdict

Approve

[warp-for-oss]

Overview

This PR updates the Terminal Prompt documentation to match the current Settings > Appearance > Input workflow, removes stale prompt media/imports, and refreshes prompt compatibility guidance.

Concerns

• No blocking concerns found. No approved spec context was provided, and the diff does not introduce security-sensitive behavior.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz