Get it for macOS

Keep project files in view while you move between BB threads. Pin a project source or thread workspace, search by name or path, and preview files. Send a file path to a chosen chat draft, create a blank markdown file, or delete a file after confirmation. Copy paths or files, and reveal files in Finder. Requires access to the files on the BB machine; Finder reveal is macOS-only.


Overview

View source

Who it is for

People who work across BB threads and need to find a file an agent mentions, preview it, or add its path to a chat draft.

What you get

Files in the tree and in search use Seti-style type icons (markdown, JSON, gitignore, .env, README, …). Folders keep only the twistie.

The tree sits in its own card on the right of the BB window, next to the thread and its preview. A folder selector pins a project source or thread workspace, so switching threads keeps the same tree state. Above the tree is a search box: type a file name, part of a path, or paste a path, and the list under it names the files that match. On a thread or New Thread page, Enter selects the file in the tree and opens its preview — one action, both results — and temporarily re-roots the tree when the file lives in another project.

In a thread or on the New Thread page, click a file to open BB's default preview. Right-click to add its absolute path to an open chat draft, create a blank .md in that folder (or the file's parent), delete a file, copy a relative or absolute path, copy the file itself onto the clipboard, or reveal the item in Finder. When several drafts are open, choose the target in the menu. Right-click the root name to create the markdown file at the top of the tree. A newly created .md opens in the external editor. When Markdown PRO is installed, right-click a Markdown file and choose Open in preview to see it in BB's standard preview instead of the editor.

Search and chat paths ask the same question of the same index. When a message names a path, the tree can jump to it. A bare file name works too: the search roots are indexed by name, so AGENTS-base.md lands on the file even when nothing in the message says which folder it is in. If the hit is in another folder, the tree re-roots there instead of reporting a miss.

How it works

The folder selector lists project sources and the current thread workspace. Set Root folder for personal threads to a path such as ~/Documents to add it to the selector. Hidden and ignored folders (.claude, node_modules, .git, …) stay hidden unless you turn them on in settings. Search roots (default ~/Documents, one path per line) are the extra places a chat path may land.

Open in Finder and Copy File are available for files on this computer. Copy File puts a real file on the macOS or Windows clipboard so Finder paste drops a copy, not a string. Finder reveal uses macOS open -R.

First step

Install File Tree, open a thread, and leave the tree open on the right. Click a file you already know. Then right-click the same file: copy it, paste into Finder, and confirm a real copy appeared.

More from Yuriy Egorov

Fast Switch AccountsSwitch to another Claude Code or Codex login when the current one runs out of quota, without leaving BB. See each saved account's remaining limits before you pick one, then start the next thread on it. Add an account through the provider's own browser sign-in. Saved logins stay in the macOS Keychain. Tokens go only to Anthropic and OpenAI. Cursor and other providers show limits only. Runs on macOS only. Codex switching needs the Codex CLI signed in with ChatGPT and the Xcode Command Line Tools.NewClose TabKeep the preview down to the files you still need, and close each tab like in a browser instead of aiming at a tiny ×. Double-click or middle-click a tab you have read; on a Mac trackpad a three-finger click works too. Control+W and a palette command close the active tab, because ⌘W closes the window. A × at the right of the preview header hides the panel when you are back to the chat.NewCompact RailMake more room on a small desktop screen with compact navigation and narrower window gutters. Use a 40 px navigation rail with full-size icons and frame gutters at 60% of their default size. Resize the thread sidebar while its list fills the available width. Requires BB 0.46+ and Plugin SDK 0.6.37+; applies to desktop widths with a fine pointer and uses internal layout selectors.NewHeader PinsSwitch between your pinned threads in one click from the empty title bar strip at the top of the BB window. Each chip carries a status dot for the thread and its child threads: yellow waits for you, blue works, green finished and unread. A colored bar marks the thread with its project color when Chat Sidebar by Evgeniy Perin is installed, which we recommend, and with its provider's color otherwise. Hover a chip to unpin it in place. Needs the BB desktop app; no account or network access.New

More in File Viewers & Editors 21

Browse, open, preview, or edit files and document vaults.

View all
File ManagerManage the files on the machine bb runs on without a terminal: browse, upload, move, rename, extract and hand them to the agent. Opens as a sidebar page, as a tab beside a thread that can start in that thread's folder, and from a file link in a message. Double-click shows images, PDF, video, Markdown and code; Space looks inside zip, tar, 7z and rar archives without extracting them. Multi-gigabyte uploads resume after a dropped connection. On a phone, selected rows get an Actions bar with the whole row menu. Access stays inside the home folder of the user bb runs as; tar, 7z and rar archives need tar and 7z on that machine.Foma443
FilesA VS Code-style file explorer and editor for the workspace behind a thread. Search in files finds a word across every file in the project: results are grouped by file with each hit highlighted, and clicking one opens the file on that line. It is smart case, with match-case, whole-word and regex toggles, and built for typing — file contents stay in memory between searches, so refining a query re-runs in tens of milliseconds, and a regex runs in its own worker so a runaway pattern cannot freeze BB. Around it: a file tree that shows dotfiles, editor tabs, a go-to-file palette (Cmd+P), find in the open file (Cmd+F), syntax highlighting in your BB code theme, and edit and save guarded so a change an agent made underneath you is never clobbered. Markdown files open rendered, with the source and the editor one click away. Two pickers choose the project and then its checkout or one of its worktrees; beside a thread it is pinned to that thread's worktree. Adds a `bb files` command so agents can browse and read the same workspace from the CLI, on whichever machine it lives.AbdElrahman Telb296