Cmd-click on sidebar session opens side-by-side split — gesture not documented

Resolved 💬 1 comment Opened May 5, 2026 by psibook Closed Jun 3, 2026

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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗