Get it for macOS

See which agent spawned which thread. A sidebar thread list where child threads nest under the thread that started them, at any depth, and a parent folds its subtree into one line that counts each state. A search field on top (or /) finds threads by title, branch, PR number or project, above counts of threads that need input, failed, are running or are unread. Needs you collects threads asking a question, failed turns, threads stuck with no progress, unread results with their diff stat, failing PRs and failed automations, with Retry, Stop and snooze in place. Running rows show the current step, a turn timer and a high context fill. Orchestrations gives a shortcut to each thread running subthreads, with its progress. Provider subagents (Claude Code Agent calls, Codex subagents) show as a counter on the parent's row with type, state, duration and tokens on hover. Threads group by project or status and sort by last activity, creation date or status, with per-folder overrides; quiet threads fold into an "N older" line you can archive at once. Folded Pull requests (with the GitHub Folder plugin) and Automations sections summarize themselves in the header; hover a PR to merge it or start an agent review. Each row stays one line: bb's own status glyph, the title and the agent provider, plus a tinted PR icon only when the pull request needs action. A ⚠ marks a thread whose branch or worktree another live thread is using. Hovering a row shows Archive and its menu; hovering a running spinner lets you stop it. Reads thread data on the bb server; PR status comes from GitHub.


Overview

View source

A sidebar thread list built around agent work: the threads an agent spawns nest under it, and the subagents it runs inside its own session show on its row.

What you get

  • A search field on top (or /) finds threads by title, branch, PR number or project. Below it, counts of threads that need input, failed, run or are unread; click one for a flat list. Running rows show the current step, a turn timer, a high context fill and the orchestration.
  • Needs you, above the sections: threads asking a question, failed turns and queued messages, threads stuck with no progress, unread results with their diff, then failing PRs of your threads and failed automations. Retry, Resend or Stop in place; hover to snooze. ⇧⌘I (Ctrl+Shift+I) opens the next.
  • Pull requests (from GitHub Folder) and Automations start folded, with a summary in the header such as "1 failing · 5". A PR's reason is its icon; hover to snooze, open its thread, merge or start an agent review. Hover an automation to run, pause or resume it; click to open its last run.
  • Threads grouped by Project, by Status or not at all, with Pinned on top. Projects keep the order you drag them into, or follow recent activity. The + on a project header starts a new thread there.
  • Sort by last activity, creation date or status, globally or per folder.
  • Archived shows archived threads in the same grouping and nesting.
  • Each child thread sits under the thread that spawned it, at any depth, even in another project. Fold a parent into one line counting its subtree by state; its glyph shows the most urgent state below. A finished fold offers Archive, skipping worktrees with uncommitted changes.
  • Per project, threads idle, read and quiet for a day fold into "N older"; expanded, it offers Archive these.
  • Projects with no turn for 24 hours, subthreads and since-archived threads included (a setting; 0 turns it off), move into "N inactive projects" at the bottom; running, asking, failed or pinned threads keep a project in place.
  • Orchestrations: a shortcut for each thread with live subthreads, most urgent first, with its progress; finished ones go last.
  • Each title starts with bb's own status glyph; a failed thread gets a Retry button.
  • Rows are one line; a tinted PR icon appears only when a PR needs action.
  • A ⚠ warns when another live thread works on the same branch or worktree.
  • Each row shows its agent provider; hover for title, branch and age.
  • Hover or focus a row for Archive and ⋯; Archive keeps bb's confirmation and Undo, and Cmd+Z or Ctrl+Z restores recently archived threads with children.
  • Hover a running thread's spinner to stop it; on touch, use the row's menu.
  • Provider subagents show a counter and status dot on the parent's row; hover for type, state, duration and tokens.
  • Hold Ctrl (or Cmd on a Mac) to see each row's jump key.
  • bb thread-tree list prints a thread's subagents from a terminal.

Arranging the sidebar

Right-click a section header to remove it; the sliders icon beside the search field brings it back, as well as Recent Activity, off by default. Drag a header, or use Move up and Move down in its menu, to reorder sections.

Settings

Thread Tree's settings hold the section switches, Recent Activity row counts, which PRs Needs you lists, provider icon colour, the inactive-project window, and switches for the subagent counters and the age label. Reduce motion, or the system's reduced-motion preference, stops the sidebar animations and holds spinners still.

How it works

The list reads bb's own thread data. Subagents come from each thread's event log on the bb server. PR checks and conflicts come from bb's GitHub PR Status plugin through the environment machine's gh login, plus Thread Links for PRs mentioned in the session; changes requested and ready to merge need the GitHub Folder plugin. Folds, grouping and order are per client; settings are shared by every client of the bb server.

More from Dmitrii Maksimov

ArtifactsOpen your published Claude Code artifacts and Codex Sites from bb, without going back to the Claude app or ChatGPT. Both lists show as one grid of preview cards, newest first, with a filter; a click opens the item in bb's browser. An agent can also show an artifact or site in chat as the same card. Reads the Claude Code login from the macOS keychain and the Codex login from ~/.codex/auth.json, and sends them only to api.anthropic.com and chatgpt.com.29BatterySee your laptop's charge in bb's sidebar without switching to the menu bar. A battery icon and percentage sit at the right end of the sidebar footer, filled red at 20% or less, yellow up to 50% and green above. A click opens a popup with each device's state and charge, including the phone or tablet you opened bb on when its browser reports a battery. `bb battery status` prints the same reading for terminals and agents. Reads the charge of the machine running the bb server, which must be a Mac; no account or external service.NewGitHub FolderThe open GitHub pull requests that need you, as a folder at the top of the sidebar: review requests, then your own PRs with changes requested, failing checks or conflicts, and the ones ready to merge. Click a PR to start a thread with its title, status, branch and description as context, in the project whose remote is that repository. Snooze a PR until it changes, and pick sources, drafts and organizations. Reads GitHub through the gh CLI on the bb server; Thread Tree draws the folder in its own list when installed.NewInline TerminalRun the commands an agent suggests right under its reply, and have the agent read the result and answer on its own. Every bash, sh, zsh or console code block in a reply gets a Run button that opens a live terminal beneath it, where you can answer prompts, type passwords and press Ctrl-C. When the block finishes, its exit code and output reach the agent as hidden context, so it replies without you pasting anything and the chat gets no extra message. The shell starts in the thread's workspace with your startup files loaded and keeps cd, virtualenvs and variables for follow-up commands. Needs a macOS or Linux machine; no account or external service.New

More in Thread Management 81

Find, identify, organize, or archive threads.

View all