File Manager

Foma File Viewers & Editors469

Get it for macOS

Manage 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.

Overview

What you get

A File Manager page in the sidebar and a tab beside any thread, both showing the machine the bb server runs on rather than the one your browser runs on.
A list with sizes and dates, folders that expand in place, a gallery of thumbnails, a filter over the rows, and an address bar that takes a pasted path.
Uploads by drag and drop, whole folders included. They go in chunks, keep running while you work elsewhere in bb, and resume after a dropped connection. Downloads stream from disk, so a 10 GB file costs the browser no memory.
Rename, move, copy, delete and new folder, with cut and paste or drag and drop. A name clash becomes name (1).ext instead of an overwrite.
Bookmarks for up to fifty folders, a start folder chosen with a folder browser, and the folder you were last in when you come back.

Reading files

Double-click, Enter or Open shows a file. Beside a thread it opens in bb's own preview panel; on the full page the plugin shows it itself: images, PDF, video and audio in place, Markdown rendered, everything else with syntax highlighting. Space gives a quick look without leaving the list. Properties lists size, times, permissions, owner and where a symlink points, and adds up a folder's size on request.

Archives

zip, tar, tar.gz, tar.bz2, tar.xz, 7z and rar archives open as a folder tree without being extracted: select one and press Space. Sizes, dates and encrypted members are shown. Extract… runs as a background job you can cancel, into a staging folder that is checked before anything is moved into place.

Working with the agent

Type @ in any composer to mention a file from this machine, or use Add to chat in the row menu. The file is read when the message is sent, so the agent never gets a stale copy. Right-click a file link in a message and File location opens its folder with the file selected. The tab beside a thread has a button that jumps to the folder the thread works in, and a setting makes the tab start there.

On a phone

Tick one or more rows and an Actions bar appears. It opens the whole row menu as a sheet from the bottom, and a long press no longer turns a row into a drag.

Limits and requirements

Everything stays inside the home folder of the user bb runs as, and every path is resolved and checked on the server before a byte moves. Extraction uses tar, unzip and 7z on that machine. Looking inside tar archives needs GNU tar, and 7z and rar need 7z; zip needs nothing. Extracting rar needs a 7z build with the RAR codec, packaged as 7zip-rar on Debian and Ubuntu.

More from Foma

Doc ReviewLeave comments on Markdown, PDF, Word, PowerPoint, Excel, and HTML files beside the chat, then hand them all to an agent in one message. Select text, draw a box around a chart on a page or slide, pick spreadsheet cells, or click any element of an HTML page, and each comment keeps its exact place; a comment on an area reaches the agent with an image of that region. Draw over an HTML prototype or a page to cross out a button, circle a block, or point an arrow to where something should move; the agent gets a picture of the page as you saw it with your strokes on top and, on HTML, the elements each stroke touches. Send the drafts to the current chat or to a new one, and each comment shows whether the agent is on it, closed it with a note on what changed, or answered with a question. Zoom pages with a pinch, the wheel, or the zoom bar and they re-render sharp, so a large drawing reads up close; a landscape or wide page keeps the document's scale and scrolls sideways, and a long document loads only the pages on screen. Workbooks open as a formatted grid, HTML files as the live page with their own styles and scripts in a sandbox that keeps them away from bb, and the same tab works in bb's mobile web app. Needs poppler-utils and LibreOffice on the machine the bb server runs on; Chrome or Chromium there adds the pictures of drawings on HTML pages.49 Server StatusTracks host RAM usage as a ring around a sidebar footer button — amber from 80%, red above 90% — and opens a panel with CPU, memory, swap, disk, load average, uptime, and OS and kernel version.51 Theme ToggleFlips bb between light and dark from a sidebar footer button: a click switches the appearance, while hovering, holding, or right-clicking opens a menu with light, dark, or system appearance and every palette installed on the host, including ones other plugins provide. The icon is a square split by a diagonal — day above, night below — and the half that is on is filled.36 Usage MeterShows Claude subscription limits as two rings around a sidebar footer button — the five-hour session and the week — and adds a Usage page that reads local Claude Code transcripts to explain where the limits went, broken down by project, model, thread, skill and subagent.55

More in File Viewers & Editors 22

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

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

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 Telb316

File TreeKeep 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.