[Docs][Desktop] Document side-conversation identity, lifecycle, inheritance, and limitations
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
Summary
Codex Desktop exposes side conversations, but the official documentation does not provide a dedicated contract for their identity, lifecycle, inherited context, persistence, or capabilities.
The current Projects and chats page explains separate chats and shared Project context. It does not explain what a side conversation is or how it differs from a normal Codex chat.
Documentation gap
Please document:
- whether a side conversation is persistent, searchable, resumable, archivable, or intentionally ephemeral;
- how users can identify it, copy its conversation ID or deep link, and determine its parent conversation;
- which parent transcript content, Project instructions, files, attachments, permissions, tools, Skills, plugins, memories, and working-directory context it inherits;
- whether activity in the side conversation can alter or interrupt the parent conversation;
- whether Goals, subagents, background work, file edits, external actions, and cross-thread messaging are supported;
- how behavior differs across Codex Desktop, CLI/TUI, IDE extension, and selected-text sidebars; and
- how users can preserve or promote a valuable side conversation into a normal persistent chat.
Why this matters
A side conversation can look and behave like an ordinary capable Codex chat. Without an official lifecycle and capability contract, users must rely on UI inference, assistant-provided runtime descriptions, source-code inspection, or experiments before deciding whether the conversation is suitable for consequential work.
The ambiguity also makes it difficult to know whether work will survive restart, appear in normal history, remain isolated from the parent, or retain access to Project context.
Requested documentation
Publish one canonical side-conversation page with:
- A lifecycle diagram showing the parent relationship and persistence behavior.
- A capability matrix covering Desktop, CLI/TUI, IDE extension, and sidebar variants.
- Explicit inheritance rules for context, files, instructions, tools, permissions, and working directory.
- Clear persistence, search, resume, archive, export, and deletion behavior.
- A visible Copy ID / Copy deep link action or documented method.
- A warning in the UI when a side conversation is ephemeral.
- Links from Projects and chats, the
/sidecommand documentation, and the side-conversation UI.
Steps to observe the gap
- Open a side conversation in Codex Desktop.
- Attempt to determine its ID, parent relationship, persistence, inherited context, and supported actions from the UI.
- Review the official Projects and chats documentation.
- Search the official documentation for “side conversation” and “side chat.”
- Observe that no dedicated public page defines the side-conversation contract.
Related issues, but not exact duplicates
- #36650 requests a Promote to chat button.
- #31543 requests
/sidesupport in the IDE extension. - #35669 reports compaction and observability failures in ephemeral side conversations.
- #34935 reports persistence loss for selected-text sidebar conversations.
- #38042 requests a broader comparison of Project and runtime types.
Those issues address adjacent features or defects. This request is specifically for one authoritative side-conversation identity, lifecycle, inheritance, and capability document.
Environment
- ChatGPT/Codex Desktop for macOS
- Version 26.818.41509, build 6962
- Observed August 23, 2026
Official documentation reviewed
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the official Projects and chats page, the /side command documentation, and the side-conversation UI across Desktop, CLI/TUI, IDE extension, and sidebar variants. Define one canonical page covering identity, parentage, inheritance, capabilities, lifecycle, persistence, and preservation, with the requested lifecycle diagram, capability matrix, links, and Copy ID or deep-link guidance.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos
- Domain
- cli, desktop, documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100