darkbloom is the provider agent CLI. It manages the local provider, the coordinator connection, models, updates and the Darkbloom Sandbox add-on. Run darkbloom --help for the full command list.
Global options
start
Serve on this Mac and install/start the provider LaunchAgent.
A first interactive
start asks how the Mac serves (Only me, Darkbloom network, or Both, me first) and what to do with memory when idle. The answers are saved.
stop and restart
stop drains accepted requests, then stops the LaunchAgent. restart drains, starts again with the saved configuration, and confirms fresh authorization. --force permits interrupting unfinished work.
status
Trust: <level> / <status> message, plus per-slot KV/MTP posture. --json prints the answers in progress only.
doctor and verify
doctor checks hardware, the local API, account link, Secure Enclave, runtime, downloaded models and coordinator connectivity. On macOS 27 it also prints an APP ATTEST section. It reports an old Darkbloom MDM profile for information only: Darkbloom no longer uses MDM, and darkbloom unenroll, choice 2, opens System Settings to remove one. --strict exits 1 on warnings too. verify is doctor --strict.
models
list shows downloaded models; catalog asks the coordinator for the current network catalog; download fetches weights; remove deletes them; location selects or inspects the model cache directory.
login and logout
login starts an RFC 8628 device-code flow and saves a provider token to ~/.darkbloom/auth_token. logout drains and stops the provider, revokes that token with the coordinator, then deletes it locally. It does not remove models, App Attest keys or profiles.
logs
dev.darkbloom.provider. --last <duration> reads history, -f follows, and --file tails ~/.darkbloom/provider.log instead.
update
--check-only reports without installing. --rollback restores the retained predecessor and quarantines the current release.
autoupdate
provider.auto_update. When enabled, the provider checks for releases on its schedule and installs them after verification.
schedule
start or restart. The wizard accepts mon…sun, ranges, weekdays, weekends and daily; an end earlier than the start crosses midnight. See Scheduling.
sandbox
setup requires an account approved for Darkbloom Sandbox and shows the plan before installing. See Set up sandbox hosting and Sandbox status, and the add-on’s own status, pause, resume, schedule, provider-hold and uninstall commands in ~/DarkbloomSandbox/darkbloom-sandbox.
waitlist
uninstall
--keep-models leaves downloaded weights for a later reinstall. --dry-run lists every path without changing anything.

