docs(cli): shell commands - #403
Conversation
Fill in cli/shell-commands.mdx: shell mode and command styling, opt-in natural language detection with /natural-language-detection, up-arrow history with shell commands, long-running/interactive command support (passthrough, interrupt hint, type-ahead carryover), full-screen alt-screen apps, and Ctrl+C stop vs double Ctrl+C exit semantics. 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 replaces the CLI shell-commands stub with a full feature documentation page covering shell mode, natural language detection, command history, long-running and interactive commands, full-screen terminal apps, and stop/exit behavior. The draft follows the docs style guide structure for feature documentation, uses the existing product variable for the CLI name, and the documented behaviors align with the available source/spec context I checked.
Concerns
- No blocking concerns found.
- No security findings; this is a documentation-only change.
spec_context.mdcontains no approved or repository spec context for this PR, so there are no spec-drift findings to report.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
Frontmatter {{WARP_CLI}} tokens aren't substituted by the build
pipeline, so the built title/description showed the raw token. Body
prose keeps {VARS.WARP_CLI}.
Co-Authored-By: Oz <oz-agent@warp.dev>
Consolidation: merge the verified content of cli/shell-commands.mdx (PR #403, branch hyc/launch-cli-cli-shell-commands) into cli/input-and-editing.mdx as a single "Input and shell commands in the Warp CLI" page. Adds shell mode, natural language detection, long-running and interactive commands, full-screen apps, and stopping/ exiting sections; merges the two history sections into one (adopting the verified submit-on-Enter semantics); rewires shell-mode links to in-page anchors. File rename to the new slug happens at integration. Co-Authored-By: Oz <oz-agent@warp.dev>
|
Content absorbed into #406 (input and shell commands) as part of consolidating the CLI docs from 13 pages to 9. The shell-commands.mdx stub will be deleted in the integration commit. |
1 participant
Pages changed
src/content/docs/cli/shell-commands.mdx(full draft, replaces stub)Features covered
!prefix to enter,Esc/Backspaceto exit,>vs!prompt marker, Shell mode statusline label,!-prefixed highlighted command rows in the transcript, note that running a command cancels an in-progress agent response/natural-language-detectiontoggle persists across sessions, agent-biased classification (single tokens switch only with command evidence)!prefix on command rows, filter/preview/submit/dismiss, commands-only list in shell modeCtrl+Don empty input and/exit; pointer to conversations page for resumeDropped/unconfirmed
!marker + highlighted row background without naming a color (plan mentioned yellow rows; current master uses a theme-blended tint).Suggested reviewer(s): Kevin (moira for manual attach)
Co-Authored-By: Oz oz-agent@warp.dev