Before you start
- Pairbar installed, with Claude or Codex open.
- Accessibility allowed, for instant ⌥/⌘ peeking (Settings → General → Permissions).
Steps
- Jump to a chat with ⌃1–9With Claude or Codex in front, ⌃1 to ⌃9 open the first nine chats on screen, in the order the list shows them.
- Search and run actions with ⌘KPress ⌘K to put the cursor in Pairbar's search. Type part of a title, project, branch or something said in a chat; actions like "New chat", "Start
" or Run " " appear too. ↑ ↓ move, Enter runs or opens, Esc clears and returns to the app. - Search from any app with ⌃⌥KAnywhere else, ⌃⌥K opens a Spotlight-style panel. Empty, it shows what needs you, what's working, what just finished and your latest chats. Press ⌃⌥K again or Esc to close it.
- Peek with ⌥Hold ⌥ (or ⌘) with the pointer over Pairbar: it fades out and clicks go through to the app's own sidebar, for example to reach regular Claude chats. Release to bring Pairbar back.
- Keep the peek with a double-tapDouble-tap ⌥ to keep the app's own sidebar showing until you double-tap again. It also ends when you switch apps, or after 30 seconds with the pointer away from the sidebar.
- Collapse Pairbar with ⌃⌥S⌃⌥S collapses Pairbar into a small round button in the corner, from any app. Press it again, or click the button, to bring it back. In the basket the sidebar is docked with the apps and stays: ⌃⌥S says so, and you switch to Overlay to hide it.
- Use single keys in a chat's menuOpen ⋯ on a row (or right-click it) and press one letter, such as P to pin or K to check in. The full list is below.
Global and sidebar shortcuts
| Shortcut | What it does | Where |
|---|---|---|
| ⌃⌥S | Show or hide Pairbar | anywhere |
| ⌃⌥K | Search: the sidebar's search over Claude/Codex, a quick-search panel elsewhere | anywhere |
| ⌘K | Put the cursor in Pairbar's search | Claude or Codex in front |
| ⌃1–9 | Open the nth chat on screen | Claude or Codex in front |
| Hold ⌥ or ⌘ | Peek at the app's own sidebar | pointer over Pairbar |
| Double-tap ⌥ | Keep the peek until the next double-tap (or an app switch, or 30 s away) |
In a chat's menu
| Key | Does | Key | Does |
|---|---|---|---|
| O | open | C | copy link |
| P | pin | F | fork |
| U | unread | H | hand off |
| R | rename | S | select |
| M | send a message | A | archive (Codex) |
| K | check in | D | hide |
Search, selection and the composer
| Where | Key | Does |
|---|---|---|
| Search | ↑ ↓ | move through actions, then chats |
| Search | Enter | run the highlighted action or open the chat (the first result if nothing is highlighted) |
| Search | Esc | clear and go back to the app |
| Chat list | ⇧-click | start selecting, or select a range |
| Chat list | click | add or remove a chat, once selecting |
| Composer | Enter | send |
| Composer | Esc | close |
| Workflow editor | ⌘↩ | save |
| Welcome window | ← → / Return / Esc | move between pages / continue / close |
Turning shortcuts off
- ⌘K and ⌃1–9: Settings → Shortcuts → "⌘K to search, ⌃1–9 to jump to a chat". While it's on, ⌘K replaces the app's own ⌘K shortcut whenever Pairbar is showing, so turn it off if you rely on Claude's or Codex's.
- Peek keys: Settings → Chats & sidebar → Peek at the app's own sidebar has separate switches for "Hold ⌥ over the sidebar", "Hold ⌘ over the sidebar" (not while you type in Pairbar) and "Double-tap ⌥ to keep it" (until the next double-tap).
Troubleshooting
- ⌘K opens Claude's or Codex's own search instead of Pairbar's
- Pairbar only takes ⌘K while it's showing and the ⌘K setting is on. Check Settings → Shortcuts, and that Pairbar isn't collapsed (⌃⌥S).
- Holding ⌥ doesn't peek
- The pointer must be over Pairbar, and the peek keys must be on in Settings → Chats & sidebar → Peek at the app's own sidebar. Allowing Accessibility makes the peek react instantly.
- ⌃⌥K only shows the sidebar
- While Pairbar is locked (the trial has ended), quick search is off and ⌃⌥K shows the sidebar instead.
Frequently asked questions
- How do I see my regular Claude chats with Pairbar open?
- Hold ⌥ with the pointer over Pairbar to peek at Claude's own sidebar, or double-tap ⌥ to keep it showing until you double-tap again (or switch apps).
- Does Pairbar override ⌘K in Claude and Codex?
- Yes, while Pairbar is showing and the ⌘K setting is on. Turn off "⌘K to search, ⌃1–9 to jump to a chat" in Settings → Shortcuts to keep the app's own ⌘K.
- What's the shortcut to hide Pairbar?
- ⌃⌥S, from any app. It collapses Pairbar into a small round button; press it again to bring it back.
- Can I search my chats from outside Claude and Codex?
- Yes. ⌃⌥K opens a quick-search panel from any app; Enter opens the chat in its app.
Related
- DocsKeyboardAll shortcuts
- DocsThe sidebarHow it sits over Claude and Codex, peeking, collapsing, tabs, the header
- Use caseSearch inside your Claude Code and Codex conversationsFull-text search across Claude Code and Codex chats, ranked titles-first, with ⌘K actions and ⌃⌥K quick search from any app.
- 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.
- DocsSearchSearch inside conversations, ⌘K actions, ⌃⌥K quick search from any app
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.