The problem
Watching a Claude chat and a Codex thread at the same time usually means two free-floating windows, each with its own sidebar taking up room. Tile them with macOS and each gets half the screen, both sidebars included; move one and the other stays behind.
- Two sidebars list two sets of chats, so a third of the space goes on navigation you don't need twice.
- The windows don't move or resize together, so the arrangement falls apart as soon as you drag one.
- Splitting the space unevenly (a wide Claude, a narrow Codex) means resizing both windows by hand, every time.
- Plugging in a display, or unplugging it, scatters them again.
How Pairbar solves it
- Allow AccessibilityMoving windows needs macOS's Accessibility permission, the same one switching apps uses. Without it, Pairbar shows how to allow it.
- Choose BasketUse the layout button in the sidebar's header (next to the new-chat button), type "Basket" in ⌘K, or give it a shortcut in Settings → Shortcuts. The window you're using stays where it is, at its size, and the other app docks next to it: on the right when there's room there, otherwise on the side with more room.
- Pick an arrangementSide by side, Stacked or Focus, from the same menu, ⌘K or the small pill on the basket's top edge. Swap apps (⌃⌥⌘S) exchanges their places; in Focus, it brings the other app to the front in the same spot.
- Share the roomDrag the line between the apps (↔, or ↕ when stacked). It settles on 50/50 when you're close, stops where either app would get smaller than 420 pt or than the app allows, and Side by side and Stacked each remember the split you set.
- Move and resize it as oneDrag the sidebar's empty space or header, or either app by its title bar, to move the basket; drag any outer edge or corner to resize it. The apps take their new places once, when you let go.
- Save the setupSettings → Windows → Save current setup… remembers the basket's frame, arrangement and split for the displays connected now. Turn on Restore a saved setup when displays change to have it come back when you plug in or unplug a display.
Shortcuts
| Shortcut | What it does | Where |
|---|---|---|
| ⌃⌥⌘S | Swap apps (in Focus, bring the other one to the front) | Claude or Codex in front |
| ⌘K | Overlay, Basket, Side by side, Stacked, Basket: Focus, Swap apps | Claude or Codex in front |
| ⌃⌥K | The same commands from any app | anywhere |
The three arrangements
| Arrangement | What you see | Good for |
|---|---|---|
| Side by side | Claude and Codex next to each other, a hairline between them | a wide display; watching a build in one while you talk to the other |
| Stacked | one app above the other (a wide, short basket grows a little first, so neither is cramped) | a tall or portrait display |
| Focus | one app at a time in the whole card, the other right behind it in the same place | a laptop screen; opening a chat of the other app swaps them in place |
Leaving Focus brings back the split you had. Overlay (the red button at the sidebar's top-left, or the layout menu) takes you back to Pairbar's starting mode: both apps in the basket's frame, one on top of the other, and the sidebar over the front one's.
One sidebar, not three
With Hide the apps' own sidebars in the basket on (Settings → Windows, on to start with), docking hides each app's own sidebar by pressing the item in its View menu, never a keystroke. Pairbar's sidebar is then the basket's only one, and the apps show just their chat. Going back to Overlay puts their sidebars back the way they were; the layout menu can show one again while you stay docked. See the apps' own sidebars.
Window buttons
- The basket's own buttons, at the sidebar's top-left, act on the whole group: red goes back to Overlay (both apps stay open), yellow minimises both apps and the basket, green fills the screen with the basket.
- Each app's own buttons still work, and Pairbar follows them: close or minimise one and its place offers Open or Restore; its green button fills the screen with the whole basket; full screen takes that app out of the group, and the other keeps its place.
Limits
- Claude and Codex won't go narrower than their own minimum width, and the basket never gets smaller than both allow. If both minimums don't fit side by side on the display, Pairbar stacks them (or shows them in Focus) and says why.
- A window already in macOS full screen, minimised or on another Space isn't moved; the basket shows what to do in its place.
- Pairbar docks each app's front window, not any others.
- With Stage Manager on, the basket still works, but Stage Manager may move one window into a stage of its own; Pairbar warns you.
From the Tasks view, Open all in basket opens a task's newest Claude and Codex chats and docks them side by side, Claude on the left.
Without Pairbar
Without Pairbar, macOS and window managers can put the two apps next to each other, but not make them behave as one:
| Approach | What it does | Trade-off |
|---|---|---|
| macOS Split View (full screen) | two apps fill a full-screen Space, with a divider you can drag | only in full screen; both apps keep their own sidebars |
| macOS window tiling (drag to an edge, or Window → Move & Resize) | snaps each window to half the screen | the windows move and resize separately afterwards |
| Stage Manager | groups windows into a stage you switch between | doesn't lay them out edge to edge or share one sidebar |
| A window manager such as Rectangle | keyboard shortcuts and saved window positions | no shared frame, and no list of your chats |
Frequently asked questions
- Is the basket a new chat app that replaces Claude and Codex?
- No. The real Claude and Codex apps stay open and do all the work; Pairbar moves their windows (with the Accessibility permission) and draws its sidebar and a thin frame around them. It never patches or injects into either app.
- Can I give Claude more room than Codex?
- Yes. Drag the line between them. There are no fixed ratios to pick; it snaps to 50/50 when you're close, and the split is remembered.
- What happens to the apps' own sidebars?
- With the setting on (it is to start with), Pairbar hides them through each app's own View menu while docked and puts them back when you return to Overlay; hiding Pairbar (⌃⌥S) shows the app's own sidebar if it's hidden, so there's always one. If an app has no such menu item, its sidebar simply stays.
- Does it work on a laptop screen?
- Yes: use Focus, which shows one app at a time in the whole card with the other right behind it. Opening a chat of the other app, or ⌃⌥⌘S, swaps them in place.
- Why does Pairbar ask for Screen Recording?
- Only for smoother animations: it uses pictures of the windows, held in memory for a fraction of a second, and takes them only when a drag is likely. It's optional; without it, moves show an outline instead.
Related
- DocsWindow layoutsOverlay and Basket: Claude and Codex with the sidebar as one window, side by side or stacked, moving together, saved setups, animation
- GuideDock Claude and Codex together in the basketPut Claude and Codex in one Pairbar frame with one sidebar: pick a layout, swap, share the room, move and resize, and save setups per display.
- GlossaryBasketPairbar's layout that docks the Claude and Codex apps with one sidebar in one frame, so they move, resize and swap as one window.
- Use caseSwitch between Claude Code and Codex on a Mac without hunting for windowsOne list for both apps; clicking a chat from the other app swaps its window into the same spot.
- Use caseUse Claude Code and Codex together and keep the official appsKeep chatting in the official Claude and Codex desktop apps; Pairbar only adds one sidebar over both, using your existing plans.
Try Pairbar free for 7 days
One sidebar for the Claude and Codex desktop apps. Everything on for 7 days, no card needed; then $49/year ($39 first year with LAUNCH), $9/month or $129 lifetime (first 200 buyers). macOS 26 or later, Apple silicon.