Skip to main content
The bor CLI (bin/bed-of-roses.cjs, also runnable as npx bor) launches the host and manages presences from the terminal. It’s the headless complement to the Main BOR app.

​
Commands

With no subcommand, bor (i.e. npx bor / npm start) launches the Electron host.

​
bor onboard

Launches the host and starts onboarding for a new presence — pick a provider, name, personality, avatar, and theme. The same flow you get on first run.

​
bor create [name]

Registers a new presence headlessly (no window) and prints its id. Give it a nickname:
The presence exists but isn’t onboarded yet — run bor onboard (or open it in the app) to configure it.

​
bor delete <presence_id>

Deletes a presence and its entire data directory (its surfaces, memory, files, config). This is irreversible.
The delete is guarded so it only ever removes a directory under os-data/presences/.

​
bor list (alias bor ls)

Lists every presence with its id, nickname, and whether it’s been onboarded:
If there are none, it tells you to run bor onboard.

​
Relationship to the app

  • bor / npx bor / npm start — launch the full Electron host (presence windows, etc.).
  • bor create/delete/list — manage the presence registry (os-data/presences.json) without a window.
  • The Main BOR app does the same management with a UI.
If the host is already running, bor create registers the presence; restart (or use the Main app) to spin up its window/runtime.

​
See also