Doc Review

FomaFile Viewers & EditorsNew
Get it for macOS

Leave comments on Markdown, PDF, Word, PowerPoint, and Excel 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, or pick spreadsheet cells, and each comment keeps its exact place; a comment on an area reaches the agent with an image of that region. 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, and the same tab works in bb's mobile web app. Needs poppler-utils and LibreOffice on the machine the bb server runs on.

Overview

View source

What you get

  • A tab beside the chat for Markdown, PDF, Word, PowerPoint, and Excel files. Links in messages, the file picker, and bb thread open all land there.
  • Comments on selected text, on a box drawn around a chart or picture, on spreadsheet cells and ranges, or on the whole document. Right-click a selection or press Cmd+Option+M (Ctrl+Alt+M) to comment without reaching for the mouse.
  • Drafts that wait until you send them: to the current chat, or to a new chat in the same project and workspace with the same model.
  • A status on every comment that follows the agent's work: waiting, done with a note on what changed, or needs you when the agent answered with a question.
  • A Doc Review page in the sidebar with the files you commented on, recent files, and a folder browser.

How the hand-off works

One message carries every draft: where it points (lines, page, slide, or cell), the quoted text or cell values, and your request. A comment on an area arrives with an image of that region, so the agent sees the chart you circled.

The bundled skill tells the agent how to change each format: Markdown directly; Word, PowerPoint, and Excel files in place, keeping their layout and formulas; and a PDF through the file it was generated from. The agent closes each comment with bb doc-review resolve or answers it with bb doc-review reply, and the tab updates while you read.

Viewing

Word and PowerPoint files are converted to PDF by LibreOffice on the bb server and cached per file version, so a document converts once. Pages render as images with a selectable text layer and stay sharp as you zoom: use the zoom buttons, Ctrl or Cmd with the scroll wheel, or pinch, and read the smallest labels on a large drawing. All pages share one scale, so a landscape sheet or a wide timeline in a portrait document scrolls left and right instead of shrinking to fit. In a long document only the pages on screen load, and the page counter jumps to any page. Classic switches to the browser's own PDF viewer for search and printing, and the download button saves the original file. Workbooks open as a grid with sheet tabs, number formats, fills, borders, merged cells, and frozen panes.

On a phone

bb's mobile web app shows the same tab. Pinch to zoom, hold and then drag to mark an area, tap a cell to comment on it, or hold and drag to select a range. The comment list opens as a sheet from the bottom.

The plugin never writes to your file. Only the agent you send the comments to changes it, and the tab picks up the new version on its own.

Requirements

  • poppler-utils (pdfinfo, pdftoppm, pdftotext) on the machine the bb server runs on, for pages and text selection.
  • LibreOffice Writer and Impress on the same machine for Word and PowerPoint files. LibreOffice Calc adds full formatting for legacy spreadsheets (xls, xlsb, ods); without it they open with values and fills.
  • Files on other bb machines are copied to the server for rendering, up to 64 MB.

More from Foma

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.353Server 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.41Theme 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.34Usage 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.43

More in File Viewers & Editors 12

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.Foma353
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. 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 Telb242
File TreeFind the file an agent mentions and keep the workspace tree beside the conversation. Search by name or path, open previews, add relative paths to drafts, create a blank markdown file, delete a file after confirmation, and reveal or copy files from the machine that owns them. Files show Seti-style type icons for markdown, JSON, gitignore, env, and other common names. Project threads stay rooted in their checkout; personal threads can browse a configured folder. Requires local file access on the BB machine; Finder reveal is macOS-only.Yuriy Egorov43