Skip to content

docs(cli): conversations - #397

Closed
hongyi-chen wants to merge 2 commits into
hyc/launch-clifrom
hyc/launch-cli-cli-conversations
Closed

docs(cli): conversations#397
hongyi-chen wants to merge 2 commits into
hyc/launch-clifrom
hyc/launch-cli-cli-conversations

Conversation

@hongyi-chen

@hongyi-chen hongyi-chen commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Pages changed

  • src/content/docs/cli/conversations.mdx (full draft replacing stub)

Features covered

  • Conversation persistence and restore: auto-save to the Warp account; reopening rehydrates the full transcript including tool calls and file-edit diffs; single-conversation surface with switch guards while a conversation/command is running
  • Starting new conversations: /new, /agent, /clear (aliases) with optional immediate prompt argument
  • Conversation history: /conversations menu and left-arrow-at-empty-input shortcut (confirmed in code, incl. the '← for conversations' ghost hint); type-to-filter, arrow navigation, Enter/Esc; list includes Warp app conversations and completed cloud agent runs; local-only fallback caution when cloud data fails to load
  • /compact: default and custom summarization instructions; collapsed 'Conversation summary' block, expandable
  • Exit/resume: exit prints 'To continue this conversation, run: warp --resume ' for non-empty conversations; --resume flag restores at startup; cross-links to cli/reference

Dropped/unconfirmed

  • Multiple simultaneous in-progress conversations: not shipped; the CLI has a single conversation surface and switching replaces it (task marked confirm-or-drop, so dropped)

Suggested reviewer(s): harry

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

@hongyi-chen @oz-agent
docs(cli): draft conversations page (persistence, history, compact, r…
ca8304a 
…esume)

Replace the cli/conversations.mdx stub with a full draft covering
conversation persistence and restore, /new//agent//clear, the
/conversations history menu (including the left-arrow shortcut),
/compact and the collapsed summary block, and the exit/--resume flow.

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

vercel Bot commented Jul 28, 2026 •
edited
Loading

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, Comment Jul 28, 2026 9:47pm

Request Review

@oz-for-oss

oz-for-oss Bot commented Jul 28, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

@hongyi-chen

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

Powered by Oz

oz-for-oss[bot]
oz-for-oss Bot reviewed Jul 28, 2026
View reviewed changes

@oz-for-oss oz-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR replaces the CLI conversations stub with a full feature-doc page covering persistence, starting new conversations, conversation history, compaction, resume, and related pages. I reviewed the attached annotated diff, PR description, and spec context; no approved spec context was available, and the docs-only change does not introduce security-sensitive behavior.

Concerns

  • No blocking concerns found.

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

@hongyi-chen @oz-agent
docs(cli): use literal Warp CLI in conversations frontmatter
b2a1cd4 
{{WARP_CLI}} tokens are not substituted in MDX frontmatter by the
build pipeline, so the built title/description showed the raw token.
Body {VARS.WARP_CLI} usages are unchanged.

Co-Authored-By: Oz <oz-agent@warp.dev>
@hongyi-chen hongyi-chen mentioned this pull request Jul 28, 2026
Open
@hongyi-chen

hongyi-chen commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator Author

Content absorbed into #399 (agent conversations + conversation management) as part of consolidating the CLI docs from 13 pages to 9. The conversations.mdx stub will be deleted in the integration commit.

@hongyi-chen hongyi-chen mentioned this pull request Jul 29, 2026
Draft
5 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@oz-for-oss oz-for-oss[bot] oz-for-oss[bot] left review comments

Assignees

No one assigned

Labels

cla-signed

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@hongyi-chen