One of your Claude Code sessions has been waiting since Tuesday.

pebl is a small jellyfish that lives in your terminal. It herds every Claude Code session into one screen and pokes you the moment one needs a yes.

pebl is a free, open-source terminal orchestrator for Claude Code: it runs several Claude Code sessions side by side in one terminal window and shows at a glance which ones need you.

Install: cargo install --git https://github.com/buricodes/pebl

Features

A Claude Code session manager that lives in your terminal: run sessions in parallel, see which one is waiting for input, get notified, and keep an eye on every context window.

It notices who’s stuck (ctrl+g)

A session waiting on you turns orange and stays orange until you deal with it. ctrl+y lists everything that does. Ignoring it is still possible, just harder.

Four Claudes, one screen (ctrl+\)

Side-by-side columns from any project. Your ultrawide monitor finally earns its price.

It watches the fuel gauge

Orange at 80% context, red at 95%, and a polite /compact before Claude forgets what it was doing.

It remembers what you said (ctrl+f)

Search every conversation you’ve had with Claude Code, even the embarrassing ones, and pick any of them back up.

Say it once, to everyone (ctrl+x)

Mark five sessions, type one prompt, send. Like reply-all, except people are happy about it.

Shells that live downstairs (ctrl+t)

A terminal under each chat, in its folder. Click + split and your backend and frontend run side by side. Claude’s commands get typed for you; you still press enter. We’re not animals.

More than one Claude account

Add your other account: pebl login

Your browser opens, you sign in, done. Each account keeps its own login, so nothing gets overwritten.

Pick who pays for what: pebl profile

Choose the account new sessions use, or tie a project to one. Client repos always open on the work account.

Switch mid-conversation: /switch

Type it inside any session. pebl reopens it on the other account with the same conversation, and Claude never sees the command.

Setup in six steps

  1. Get Rust: pebl is built with cargo. Skip this if cargo --version already works. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  2. Get tmux: pebl runs your sessions in its own private tmux server. brew install tmux (macOS) / sudo apt install tmux (Linux)
  3. Log in to Claude Code: Install it from the Claude Code docs, then run it once to log in. claude
  4. Install pebl: Takes about a minute the first time. cargo install --git https://github.com/buricodes/pebl
  5. Check everything: pebl doctor tells you exactly what is missing, if anything. pebl doctor
  6. Open a project: Press enter and the folder becomes your first project. Later, pebl update gets the newest version. cd ~/code/my-app && pebl

Keys

FAQ

The things people search for before they try running Claude Code in parallel.

What is pebl?

pebl is a free, open-source terminal orchestrator for Claude Code: it runs several Claude Code sessions side by side in one terminal window and shows at a glance which ones need you. It has a project sidebar on the left, the real claude CLI in the main pane and a status bar at the bottom. It is MIT licensed and not affiliated with Anthropic.

How do I run multiple Claude Code sessions at the same time?

Install pebl, run pebl in a project folder, and press ctrl+n for each new Claude Code session. Every session keeps running in the background; ctrl+j and ctrl+k switch between them, and ctrl+\ opens up to four side by side in columns.

Can I get a notification when Claude Code needs input or finishes?

Yes. On macOS pebl sends a desktop notification when a session is waiting, errors or finishes, and clicking it opens that session. It can also play a chime, ring the terminal bell (the Linux default), send a notification through Ghostty, iTerm2, Kitty or WezTerm, or push to your phone with ntfy.sh if a session stays unanswered for two minutes.

View all 18 questions

GitHub · Docs · Changelog