File Gateway

Browse files across your BB machines and FTP/SFTP sites, then add the right file to a chat. Preview folders and media, download individual files or a folder’s visible files as a ZIP, and insert native file mentions without exposing account passwords to agents. Requires connected BB machines or reachable website accounts; macOS/Linux, read-only website access, 256 MiB between BB hosts and 32 MiB from websites. English interface with drag-to-chat mentions and hidden-file controls.

Overview

View source

File Gateway for BB — Cross-Machine Files, Remote Mentions & FTP/SFTP Explorer

Working on a server while your document is on a Mac? File Gateway lets your agent list a shared folder, read text, or copy a file to another enrolled machine without setting up SSH or publishing a download link.

What it provides

A native tree in the chat side panel, including before the first message. The first level opens automatically; a toggle shows hidden entries. Drag files or folders into chat as mentions that identify their source and path. Double-click a file to open the native BB viewer in an existing chat.
FTP, FTPS and SFTP website accounts alongside BB machines; passwords stay in BB secret storage.
An agent tool and bb file-gateway commands to discover machines, browse folders, read text and transfer files.
Private transfers over BB's existing host connection, with chunked delivery and SHA-256 verification.
Native settings cards for each machine: Off, Selected folders, or Full computer. Choose remote folders without editing JSON.
Unique destination files: existing files are never overwritten.

Nothing is shared until you configure it. Selected folders mode excludes common credential paths and symbolic links. Full computer mode opens all files readable by BB, including hidden files and credentials, and follows links. Operating-system permissions still apply.

Folder view

Click a folder path in a chat message to open it as a panel tab on that chat's machine: breadcrumbs, icons or list, image thumbnails, in-panel preview of images, PDF, video and audio, download to your computer, native mentions and copy path. The same access policy applies as for the rest of the plugin.

Beta limits

Requires BB 0.43 or newer and Plugin SDK 0.4.87 or newer. Supports macOS and Linux, files up to 256 MiB, and single-file transfers. No Windows support, recursive folder copies, resumable transfers or arbitrary remote editing yet. Copies persist in the receiving machine's plugin imports folder until you remove them locally.

Website transfers are read-only, up to 32 MiB, and originate from the BB server. FTPS verifies certificates; SFTP verifies a configured SHA-256 host-key fingerprint and supports password authentication. No website uploads or edits. The interface, documentation and agent instructions are in English.

The folder toolbar can download the visible files in the current folder as a ZIP archive. Subfolders are not included. Use the media viewer’s back button to return to the folder.

More from VKirill

Agent ToolsShow which MCP servers and skills each BB machine actually has, then bring them to one catalogue and one canon. A matrix marks present, missing, and drifted configs; new servers wait for adopt, keep-local, or hide. Sync adds what is missing and never deletes on its own. The Skills tab treats ~/.agents/skills as a git canon, with fan-out into CLI homes and a version archive. Writes back up each config first; loopback paths and local secrets stay on that machine. Optional MetaMCP listing needs that gateway's API key.54 CLI AgentsStart each chat with a specialist agent or selected profile instructions. Choose native Claude Code and OpenCode agents, or Codex profile developer instructions (up to 4096 characters; other profile settings are not applied), in new chats and handoffs on local or enrolled remote machines. Requires BB 0.43.0 or later on macOS or Linux and an installed, authenticated supported CLI; provider subscription limits or API charges apply.5 Env CatalogStore API keys, tokens, and secrets in a single encrypted catalog across all BB sessions and machines. Securely request credentials via masked in-app modals. Agents automatically check available credentials before prompting you, and persist newly provided keys on demand. Values are encrypted at rest with AES-256-GCM and synchronized via your central BB server. Includes dedicated agent tools, a full-featured management UI with .env import/export, and terminal CLI commands.64 Image StudioKeep generated project photos in a gallery and create or edit the next image from the panel or chat. People profiles use labeled reference sheets and can build missing face, body, and detail views for reuse across models. Nano Banana 2, 2.1, Pro, and Muse Image use paid fal.ai or kie.ai API keys; Muse Image requires fal.ai. The chat Send form remembers the model, frame, and size, with 2K as the default size; the interface supports English and Russian, and Env Catalog can hold the keys.7

More in Environments & Cloud 15

Create and manage where threads run, locally or in the cloud.

View all

Modal SandboxExperimentalRun bb threads in on-demand, isolated sandboxesBB193

Telegram ProjectsGet BB agent reports in Telegram and answer any thread from your phone, one topic per project. When an agent finishes, waits for you or stops, its project topic gets a card with the section, thread and agent, and the reply collapsed or summarized by a BB model you choose. Connect the reported thread with one tap and keep working with that agent by text or voice. Pick which agent and Tasks events arrive, with or without sound, and use the bot in Russian or English. Requires your own Telegram bot; messages of connected chats and reports are sent to Telegram.

Kirill Vechkasov47

Server SwitcherSee which bb server you are on and switch to another server on your account in one click. A strip above the sidebar footer shows the current server's name, address, online status, and your GitHub avatar. Click it to list the other servers on your bb account; offline servers are greyed out, and in the desktop app the switch goes through the app's own server menu. Give each server its own colored ring, from seven presets, a custom color, or a two-color gradient, in a picker beside the sidebar or with the bb server-switcher ring command. Requires a bb signed in to a bb account with the bundled bb connect plugin enabled.

brsbl30