Skip to main content

​
fased doctor

Run health checks and guided repair suggestions for the gateway, config, local state, and configured channels. Browser equivalent: use focused pages first, then Logs and Advanced > Debug for operator diagnostics. Memory repair preview and execution boundaries are documented under Memory Doctor. Related:

​
Examples

fased doctor
fased doctor --repair
fased doctor --fix
fased doctor --non-interactive
fased doctor --generate-gateway-token
fased doctor --deep

​
Options

  • --repair: apply recommended repairs without prompting.
  • --fix: alias for --repair.
  • --force: apply aggressive repairs that may overwrite custom service config.
  • --yes: accept defaults without prompting.
  • --non-interactive: run without prompts; safe migrations only.
  • --generate-gateway-token: generate and configure a gateway token.
  • --no-workspace-suggestions: disable workspace memory suggestions.
  • --deep: scan system services for extra gateway installs.
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 ~/.fased/fased.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 fased 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 fased config set agents.defaults.sandbox.mode off).

​
macOS: launchctl env overrides

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

launchctl unsetenv FASED_GATEWAY_TOKEN
launchctl unsetenv FASED_GATEWAY_PASSWORD