Skip to main content

​
fluffbuzz doctor

Health checks + quick fixes for the gateway and channels. Related:

​
Examples

fluffbuzz doctor
fluffbuzz doctor --repair
fluffbuzz doctor --deep
Notes:
  • Interactive prompts (like keychain/OAuth fixes) only run when stdin is a TTY and --non-interactive is not set. Headless runs (cron, Telegram, no terminal) will skip prompts.
  • --fix (alias for --repair) writes a backup to ~/.fluffbuzz/fluffbuzz.json.bak and drops unknown config keys, listing each removal.
  • State integrity checks now detect orphan transcript files in the sessions directory and can archive them as .deleted.<timestamp> to reclaim space safely.
  • Doctor includes a memory-search readiness check and can recommend fluffbuzz configure --section model when embedding credentials are missing.
  • If sandbox mode is enabled but Docker is unavailable, doctor reports a high-signal warning with remediation (install Docker or fluffbuzz config set agents.defaults.sandbox.mode off).

​
macOS: launchctl env overrides

If you previously ran launchctl setenv FLUFFBUZZ_GATEWAY_TOKEN ... (or ...PASSWORD), that value overrides your config file and can cause persistent “unauthorized” errors. 
launchctl getenv FLUFFBUZZ_GATEWAY_TOKEN
launchctl getenv FLUFFBUZZ_GATEWAY_PASSWORD

launchctl unsetenv FLUFFBUZZ_GATEWAY_TOKEN
launchctl unsetenv FLUFFBUZZ_GATEWAY_PASSWORD