claude-code - 💡(How to fix) Fix Cmd-click on sidebar session opens side-by-side split — gesture not documented [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56278Fetched 2026-05-06 06:32:23
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×4

Error Message

Add a documentation passage covering this gesture — ideally in Manage sessions, or as a new Side-by-side sessions subsection — so the workflow is discoverable without trial and error. The geometry is consistent whether Claude.app runs natively or inside a UTM guest.

RAW_BUFFERClick to expand / collapse

Doc request — Cmd-click on sidebar session opens side-by-side split (undocumented gesture)

Environment

  • Host OS: macOS Sequoia
  • Hardware: MacBook Pro, late-2023 (M3-class), 128 GB RAM, 8 TB internal storage
  • Virtualization: UTM running a guest macOS instance
  • Claude.app: version 2.1.119, running inside the guest
  • Working surface: the Code tab within Claude.app

What I want

Two Claude Code sessions visible side-by-side in the same Claude.app window — so I can read context or instructions from one session and use them to start a second session, without losing sight of either.

Gesture

  1. With one session displayed solo in the Code tab's workspace area, I find a second session in the session sidebar (the list on the left of the Code tab — the same sidebar described in the docs at Manage sessions and Arrange your workspace).
  2. I Cmd-click that second session.
  3. The second session opens in a new pane to the right of the currently displayed session. Both sessions are now live, side-by-side, in the workspace area.
  4. A subsequent Cmd-N (or + New session click) creates a brand-new session that replaces one of the two side-by-side panes rather than appending a third.
  5. To swap which session a pane shows, I click another session in the sidebar — it takes the place of the focused pane. Each pane also has a dropdown that switches the pane's view between chat, terminal, and file (per-pane, independently).

What the docs don't cover

In https://code.claude.com/docs/en/desktop.md:

  • Line 142 (Arrange your workspace) describes pane layout within a single session (chat / diff / preview / terminal / file / plan / tasks / subagent), not across sessions.
  • Line 283 (Manage sessions) describes Cmd-N and + New session for parallel sessions, but says nothing about how those parallel sessions are arranged relative to each other.

Neither passage documents:

  • The Cmd-click on a sidebar session gesture for adding a second session into a side-by-side split inside the same window
  • Cmd-N's behavior of replacing one of the side-by-side panes once the split is active (vs appending a third)
  • The per-pane dropdown for switching a pane's view between chat / terminal / file

Request

Add a documentation passage covering this gesture — ideally in Manage sessions, or as a new Side-by-side sessions subsection — so the workflow is discoverable without trial and error. The geometry is consistent whether Claude.app runs natively or inside a UTM guest.

extent analysis

TL;DR

The documentation for Claude.app should be updated to include the Cmd-click gesture for opening a second session in a side-by-side split and its associated behaviors.

Guidance

  • Review the existing documentation at https://code.claude.com/docs/en/desktop.md to understand the current coverage of session management and workspace arrangement.
  • Identify the gaps in documentation, specifically the Cmd-click gesture, Cmd-N behavior in a side-by-side split, and the per-pane dropdown for view switching.
  • Consider adding a new subsection, such as Side-by-side sessions, under Manage sessions to document these features and their interactions.
  • Ensure the new documentation covers the consistent geometry of side-by-side sessions whether Claude.app runs natively or inside a UTM guest.

Example

No code snippet is applicable in this case as the issue pertains to documentation.

Notes

The request is focused on improving the discoverability of a specific workflow in Claude.app through better documentation, rather than addressing a technical issue or bug.

Recommendation

Apply workaround: Update the documentation to include the missing information about side-by-side sessions and their management, as this will directly address the user's request and improve the overall usability of Claude.app.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING