Empirical Docs / CLI Reference

Doctor and update commands.

Diagnose authentication, connectivity, workspace selection, and CLI version problems with a single repeatable check.

Run doctor

Doctor checks the local token, API connectivity, account identity, and workspace status. Run it after installation and whenever an agent reports that Empirical is unavailable.

empirical doctor
empirical doctor --output json

Check for updates

Use update --check to see whether a newer CLI release is available without changing the installation.

empirical update --check

A reliable troubleshooting order

Start with doctor, then confirm the active workspace, then check the plugin or MCP client. Re-authenticate only after diagnostics show an auth problem.

  • empirical doctor
  • empirical workspace current
  • empirical plugin check --force
  • empirical auth login

Last updated: July 31, 2026