Get it for macOS

Comment on documents, spreadsheets, and web pages beside the chat, then hand every comment to an agent in one message. Select text in Markdown, PDF, Word, or PowerPoint files, box a chart on a page or slide, pick spreadsheet cells, or click any element of an HTML page; a comment on an area reaches the agent with an image of that region. Draw over a prototype or page to cross out a button, frame a block, or point an arrow to where it should move, and the agent gets the page as you saw it with your strokes on top. Each comment shows whether the agent closed it with a note on what changed or answered with a question, and a thread under it carries the conversation for as many rounds as it takes. In the bb desktop app, a Review button beside the browser's address bar puts the same comments on a live site, where they stay on their pages across reloads and deploys. Download a PDF with your comments as annotations any PDF viewer shows; Doc Review in another bb imports them, so a colleague can answer and send the file back. Files attached to chat messages open in the same tab, and the 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.


Overview

View source

What you get

  • A tab beside the chat for Markdown, PDF, Word, PowerPoint, Excel, and HTML files. Links in messages, the file picker, and bb thread open all land there, and so does a file attached to a message.
  • Comments on selected text, on a box drawn around a chart or picture, on spreadsheet cells and ranges, on any element of an HTML page, or on the whole document. Right-click a selection or press Cmd+Option+M (Ctrl+Alt+M).
  • Drawing over HTML pages, PDFs, and slides with a pen, a straight line, an arrow, or a box: cross out a button, frame a block, draw an arrow to where it should move. The agent gets a picture of your strokes over the page as you saw it, and on HTML the elements each stroke touches.
  • Drafts that wait until you send them: to the current chat, or to a new one in the same project and workspace with the same model.
  • A status on every comment: waiting, done with a note on what changed, or needs you when the agent answered with a question.
  • A thread under every comment: answer the agent's question or correct what it did, and the agent replies there, as many rounds as it takes.
  • Live sites in bb's browser (desktop app): press Review beside the address bar and comment on the running page by text, element, or drawing. Comments stay on their pages across reloads and deploys, and Send hands them to the chat that owns the tab.
  • A PDF with comments to send to anyone: highlights, boxes, and drawings as annotations any PDF viewer shows, with a numbered list of comments at the end. Doc Review in another bb imports them, so a colleague can reply or hand them to an agent and send the file back.
  • A Doc Review page in the sidebar with the files you commented on, recent files, and a folder browser.
  • English or Russian interface: one EN | RU switch for all the author's plugins, the browser's language by default.

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 with bb doc-review reply, and the tab updates while you read. Your reply in a thread goes out with the next batch, together with the conversation so far.

Viewing

Word and PowerPoint files are converted to PDF by LibreOffice on the bb server and cached per file version. Pages stay sharp at any zoom: buttons, Ctrl or Cmd with the wheel, or a pinch. All pages share one scale, so a landscape sheet scrolls sideways instead of shrinking, and a long document loads only the pages on screen. Classic switches to the browser's PDF viewer for search and printing. Workbooks open as a grid with sheet tabs, number formats, fills, borders, merged cells, and frozen panes. HTML files open as the live page in a sandbox that keeps its scripts away from bb; a prototype with desktop and phone frames takes comments inside both.

On a phone

bb's mobile web app shows the same tab. Pinch to zoom, hold and drag to mark an area or draw, tap a cell to comment on it. 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.
  • LibreOffice Writer and Impress on the same machine for Word and PowerPoint files. LibreOffice Calc adds full formatting for legacy spreadsheets (xls, xlsb, ods).
  • Optional: Chrome or Chromium there for pictures of drawings on HTML pages.
  • Files on other bb machines are copied to the server for rendering, up to 64 MB.

More from Foma

More in File Viewers & Editors 38

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, and several files or a whole folder download as one zip. 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.Foma584
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 Telb439