CLI

Operate BRB locally with watch mode or the macOS daemon

The CLI registers repos, runs manual syncs, watches a repo live, and can run as a login daemon that watches every registered repo automatically.

CLI entrypoints

brb help
  • init registers a repo.
  • sync pushes the current delta once.
  • watch runs the live batching loop for one repo.
  • daemon run watches every repo in the local registry.
  • daemon install writes a launchd plist for login startup on macOS.

Daemon install

brb daemon install \
  --base-url http://localhost:3000 \
  --quiet-window-ms 5000 \
  --max-batch-window-ms 30000 \
  --min-resync-gap-ms 2000
Load the launchd agent
launchctl load -w ~/Library/LaunchAgents/com.brb.daemon.plist

Registry and logs

  • Registry: ~/.brb/registry.json
  • Daemon stdout: ~/.brb/logs/daemon.out.log
  • Daemon stderr: ~/.brb/logs/daemon.err.log
  • Legacy ~/.git-agent state is still read for compatibility when present.