Get it for macOS

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


Overview

View source

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

What you get

  • A Docs panel with a folder tree, search, and a rich Markdown editor. Tables, images, and YAML frontmatter are supported.
  • Vaults. Each vault is a folder on a host. A new install starts with a Personal vault at ~/Notes. Add vaults on other machines that are enrolled as bb hosts.
  • Full HTML pages and embedded HTML blocks render in a sandboxed frame. Keep interactive reports next to your notes.
  • A Markdown opener for .md files from file links. Make it the default under Settings.
  • @ mentions. Type @ in the composer to attach a document. The agent gets its current content at send time.
  • Open documents update live when an agent, the CLI, another window, or another editor changes them. If a change lands while you are typing, your text is kept and you choose to keep yours or take theirs.
  • Editable document cards in agent replies. Edit Markdown directly in the timeline or open the same document in a tab, with shared autosave.
  • Review agent proposals with live diffs. Edit the proposed text, accept or reject it, undo or redo, or ask the agent for changes through a document mention.
  • Copy the current draft from the header. Progress appears during saves and proposal actions, and recent documents stay visible when returning to a thread.

For agents

Agents get the docs skill and the bb docs command. They list vaults with bb docs vaults and read files with bb docs read. They edit with bb docs pull, bb docs status, and bb docs push. Push uses version checks, so a concurrent edit is reported as a conflict instead of being overwritten.

Agents can propose changes with bb docs propose without replacing the saved document. Proposal updates and approval actions check versions to protect concurrent edits.

More from BB

More in File Viewers & Editors 40

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.Foma677
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 Telb532
Doc ReviewComment 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.Foma138