Pairbar documentation
Pairbar is one sidebar for the Claude and Codex desktop apps. It draws over their own sidebars and lists your coding chats from both. These pages describe everything it does.
New here? Start with Getting started, or follow a step-by-step guide.
All pages
- Getting startedInstalling, the welcome window, permissions, first steps
- The sidebarHow it sits over Claude and Codex, peeking, collapsing, tabs, the header
- Window layoutsOverlay and Basket: Claude and Codex with the sidebar as one window, side by side or stacked, moving together, saved setups, animation
- ChatsThe chat list: status, grouping, sorting, filters, pins, labels, hover details, subagents, bulk actions, the chat menu
- TasksChats grouped by the branch or worktree they work on, across Claude, Codex and the cloud: needs you, working, ready to review, done, with each task's PR and checks
- SearchSearch inside conversations, ⌘K actions, ⌃⌥K quick search from any app
- New chatsThe composer: app, folder, branch, worktree, agent, skills, model, effort, mode, cloud; searchable pickers, remembered choices, and the Claude-or-Codex suggestion
- Voice dictationTalk instead of typing into the composer or Claude's and Codex's chat boxes: on this Mac, automatic language, coding words, automatic Polish, OK or Send, history
- Working across chatsHandoff, fork from a message, sending a message without opening a chat
- AgentsYour Claude Code agents: where they come from, the Agents page, creating and improving them with Claude, `dock.yaml`
- SkillsEvery Claude and Codex skill in one library: which app sees which, duplicates and drifted copies, making a skill available to the other app, using skills in workflows and chats
- WorkflowsScheduled prompts, check-ins on a chat, run history, limits
- NotesLocal text and voice notes, screenshot (Coming Soon) feedback, groups, browser elements (Coming Soon) and context packages
- LimitsUsage rings, the limits card, how limits are read, memory and CPU on this Mac
- Staying informedNotifications, sounds, the menu-bar badge
- Trial, licence and updatesThe 7-day trial, the plans (yearly, monthly, lifetime), buying and activating, the lock screen, moving to another Mac, updates
- IntegrationsLive status for Claude and Codex through their hooks, Pairbar's tools for their chats (the plugin, the `pairbar` command, the tool reference, who's calling, agent activity), and agent actions: second opinions, reviews, helper chats, handoffs, workflow runs and drafts, and check-ins that agents ask for and you approve, with budgets and guardrails
- Release featuresWhich features ship, the shared release config, development previews and Coming Soon status
- SettingsEvery setting, explained
- KeyboardAll shortcuts
- TroubleshootingCommon problems and fixes
- PrivacyWhat is read, stored and sent
Popular guides
- Capture (Coming Soon) browser feedback (Coming Soon) with screenshots (Coming Soon) and DOM (Coming Soon) details
- How to install Pairbar and set it up on your Mac
- How to buy, activate and move your Pairbar licence
- Install the claude, codex and gh command-line tools for Pairbar
- Set up a Codex Cloud environment and start cloud tasks from Pairbar
- Create a Claude Code agent (subagent) with Pairbar or by hand