Skip to content

docs: multi-chat support and misc updates#6753

Merged
dianed-square merged 3 commits intomainfrom
docs/multi-chat-support
Jan 27, 2026
Merged

docs: multi-chat support and misc updates#6753
dianed-square merged 3 commits intomainfrom
docs/multi-chat-support

Conversation

@dianed-square
Copy link
Contributor

@dianed-square dianed-square commented Jan 27, 2026

Summary

This PR documents multi-chat support in goose Desktop. It also updates some other sections to align with

Documentation updates:

  • documentation/docs/guides/sessions/in-session-actions.md:
    • Update step that said to click Chat on the sidebar (which now creates a new chat)
  • documentation/docs/guides/sessions/session-management.md:
    • Restructure "Start Session" section to de-emphasize opening in a new window
    • Restructure "Resume Session" section with "Switch Between Active Sessions" and "Resume from Session History" subsections
    • Change all "History" button references → "View All"
    • Misc updates:
      • Add "Focus goose Window" keyboard shortcut (Cmd+Option+G / Ctrl+Alt+G)
      • Remove "Search Within Historical Session" subsection (view-only support was removed)
      • Remove "Resume Session Across Interfaces" section because it just works now for both
      • Reference session name (description is now legacy)

Type of Change

  • Feature
  • Bug fix
  • Refactor / Code quality
  • Performance improvement
  • Documentation
  • Tests
  • Security fix
  • Build / Release
  • Other (specify below)

AI Assistance

  • This PR was created or reviewed with AI assistance

Testing

Manual testing


@dianed-square dianed-square requested a review from a team as a code owner January 27, 2026 20:58
Copilot AI review requested due to automatic review settings January 27, 2026 20:58
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the goose Desktop documentation to reflect multi-chat support and related UI changes. The updates ensure users understand how to manage multiple concurrent sessions and navigate the updated interface.

Changes:

  • Documents multi-chat support with visual status indicators (blue spinner, green/red dots, chef hat icon for recipes)
  • Updates UI navigation instructions to reflect the new Chat section behavior and "View All" button
  • Adds "Focus goose Window" keyboard shortcut and removes obsolete cross-interface resume section
  • Clarifies session naming terminology and restructures session resumption documentation

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
documentation/docs/guides/sessions/session-management.md Main documentation updates for multi-chat support, session management UI changes, and keyboard shortcuts
documentation/docs/guides/sessions/in-session-actions.md Updated navigation instructions for accessing chat settings and returning to chat sessions
Comments suppressed due to low confidence (1)

documentation/docs/guides/sessions/session-management.md:90

  • The modal title and instructions still reference "session description" but the text at lines 81-83 has been updated to use "session names". For consistency, consider updating line 89-90 to refer to "session name" instead of "session description" to match the terminology shift mentioned in the PR description.
        5. In the "Edit Session Description" modal that opens:
           - Enter your new session description (up to 200 characters)

@github-actions
Copy link
Contributor

github-actions bot commented Jan 27, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://block.github.io/goose/pr-preview/pr-6753/

Built to branch gh-pages at 2026-01-27 21:11 UTC.
Preview will be ready when the GitHub Pages deployment is complete.


:::tip
On macOS, you can use the goose dock icon to quickly start sessions:
:::info Starting Sessions in a New Window
Copy link
Contributor Author

Choose a reason for hiding this comment

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

de-emphasize this option

@zanesq
Copy link
Collaborator

zanesq commented Jan 27, 2026

Just a note we plan on removing the new window icon in an upcoming release since we have multi chat now there isn't a need to have it front and center anymore and new windows can be created using other means like the menu bar and keyboard shortcuts.

Copilot AI review requested due to automatic review settings January 27, 2026 21:07
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

documentation/docs/guides/sessions/session-management.md:90

  • This line references "Edit Session Description" modal, but the surrounding documentation (lines 81, 83) uses "session names" terminology. The actual UI modal title is still "Edit Session Description" (confirmed in ui/desktop/src/components/sessions/SessionListView.tsx:137), which creates an inconsistency. Consider updating line 90 to say "Enter your new session name" to align with the updated terminology used throughout this documentation, even though the modal title hasn't been updated yet in the UI.
        5. In the "Edit Session Description" modal that opens:
           - Enter your new session description (up to 200 characters)

<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
In the Desktop app, session tiles display auto-generated descriptions based on the context of your initial prompt.
A session's display name is auto-generated based on the context of your initial prompt. Session names help you identify goose sessions so you can switch between active sessions or [resume a session](#resume-session).
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is based on session.name now (description is legacy field). I opened an issue to change the modal title to "Edit Session Name".


You can switch between active sessions in the sidebar or resume any session from your history.

#### Switch Between Active Sessions
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Added the feature details here because I'm guessing that people would naturally think of switching between sessions as a "resuming" action - even though technically the sessions stay active in the background.

@dianed-square dianed-square merged commit 48e7b50 into main Jan 27, 2026
28 checks passed
@dianed-square dianed-square deleted the docs/multi-chat-support branch January 27, 2026 22:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants