Host workers

bb 0.43.3·SDK 0.4.104·pinned e865697 (desktop-v0.43.3)

experimental Plugin backend Show on the zone map

Runs the plugin's code on an enrolled machine, not only on the bb server. With this, a plugin can:

Run code on enrolled machines

What it gives you

• Ship a Node entry point bb starts on demand on the machine it calls
• Call that worker from its server code over typed RPC
• Do work that has to happen on the machine itself, such as watching files or holding a wake lock
• Declare desired loopback ports once and let bb deliver retained declarations when an enrolled machine reconnects
• Kill whatever is still running under a directory it is about to delete, SIGTERM then SIGKILL, so a torn-down workspace leaves nothing behind
• Spawn host-local commands with a sanitized inherited environment

API

Each symbol links to the pinned commit it was read at.

• PluginHosts interface
• experimental_killProcessesWithCwdUnder const
• experimental_sanitizeInheritedChildProcessEnv const
• ExperimentalSanitizeInheritedChildProcessEnvArgs type
• experimental_spawnPortableOutputProcess const

Used by

Project checkout, Keep Awake, Personal workspace, Remote access, Worktree

Brief for agent…as a bb mentionAdd to set

The brief is Markdown, written for a coding agent: what the capability is, where it registers, every SDK symbol with a pinned permalink, the rules that bite, and what done means.