Doc Review
Leave 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.
Overview
View sourceWhat 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 openall land there. - 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) to comment without reaching for the mouse.
- Drawing over HTML pages, PDFs, and slides: cross out a button, circle a block, draw an arrow to where it should move, and comment on the drawing. 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 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. HTML files open as the live page, with the styles, pictures, and scripts next to them, in a sandbox that keeps the page's scripts away from bb; a prototype that shows its page in 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 then drag to mark an area or draw, 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. - Chrome or Chromium on the same machine, optional, 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 21
Browse, open, preview, or edit files and document vaults.

