Finder

Naufal Riza Fatahillah File Viewers & Editors

Browse, edit, and save the files an agent is working on without leaving BB. A file tree with new file, rename, upload, and delete sits beside the thread, and search in files reads every file in the workspace and opens a hit at its line. The CodeMirror editor saves with compare-and-swap, so a change the agent made while you were typing stops the save instead of overwriting it. An @ mention attaches a file whose contents are resolved at send time, and markdown renders Mermaid diagrams. A workspace on another machine works the same way.

Overview

View source

Browse, edit, and save the files of a project, environment, or thread workspace without leaving BB.

What you get

A Finder page in the sidebar with a workspace picker, and a Finder tab beside every thread, toggled by the folder button in the thread header.
A file tree with a dotfile toggle, a path filter, expand/collapse all, refresh, new file, new folder, upload, rename, and delete. Right-click a row for the same actions plus copy-path.
Search in files: reads file contents across the whole workspace or one folder, with match case, regexp, and whole-word toggles. Results group under a sticky file header and a hit opens the file at its line.
A CodeMirror editor with syntax highlighting in your BB code theme, find in file, go to line, multi-cursor, and code folding.
Auto-save (off by default) and a line-wrap toggle, both remembered between sessions.
A markdown preview that renders Mermaid diagrams with BB's own message renderer, so it looks like the rest of BB.
Copy the file's contents or its path in one click.
Add the file to the prompt: it becomes an @ mention whose contents are resolved when the message is sent, so the agent reads the file as it is then.
File references BB opens from chat render in this editor instead of BB's read-only preview, with line targeting, find, edit, and save. Markdown keeps BB's preview.

How it works

The plugin resolves a workspace to a directory and a machine, then reads and writes through BB's host-aware file API, so a workspace on another machine works the same way. Paths are confined to the workspace root.

Every save carries the hash the edit was based on. If an agent changed the file while you were typing, the save stops with a conflict notice and offers Reload or Save again rather than overwriting the agent's work.

A write from anywhere, another tab, another device, or the plugin's CLI, refreshes every open tree over realtime.

For agents

The bundled skill teaches an agent to resolve the workspace with bb finder root before touching paths, list it with bb finder tree, and read a file with bb finder read <path>. That matters because the workspace is not always on the machine the agent runs on.

More from Naufal Riza Fatahillah

Password GateLocks the bb app behind a password, so an unattended window stops exposing your threads. Set the password in Settings, and every window shows an unlock panel until someone enters it. Tick Trust this device once and that browser skips the prompt until the trust window ends. Forgot it? The panel covers the Settings page, so run `bb password-gate reset` in a terminal to open the app again. The lock is the app window, not your data: it does not stop anyone who can run commands on the bb machine or reach its port.New

More in File Viewers & Editors 19

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

View all

DocsCollaborate with agents on editing Markdown docs inline. Edit directly inside threads, approve/reject proposals from an agent, and undo/redo changes.BB752

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.

Foma421

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 Telb288