Search docs

Jump to a BRB documentation page

CLI

Operate BRB locally with watch mode or the macOS daemon

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

Operations
https://docs.brbgit.com/cli-and-daemon

CLI entrypoints

bash
brb help
  • login authenticates the CLI.
  • 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

bash
brb daemon install
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.