| title | ox doctor |
|---|---|
| description | CLI reference for ox doctor |
| sidebar_position | 40 |
Run diagnostics on ox installation and configuration
Run comprehensive diagnostics on your ox installation, project configuration, git health, agent environment, and connected services. Use --fix to auto-repair common issues, or --fix-slug to target specific checks.
ox doctor [flags]
--fix automatically fix issues where possible
--fix-slug strings fix specific issue(s) by slug (repeatable, e.g., --fix-slug=ledger-path --fix-slug=team-symlink)
--force-session-uploads Force detection and upload of incomplete sessions
--gc force garbage collection (reclone) of team contexts
-h, --help help for doctor
-v, --verbose show all checks including passed and skipped
-y, --yes answer yes to all prompts (for non-interactive use)
-c, --config string config file path (default: .sageox/config.yaml)
--json output in JSON format (default: false)
--no-interactive disable spinners and TUI elements (auto-enabled when CI=true)
--profile generate CPU profile and execution trace for performance analysis (default: false)
-q, --quiet suppress non-error output (default: false)
- ox - Shared team context that makes agentic engineering multiplayer