CLI
ox doctor
Run diagnostics on your SageOx setup to identify configuration issues, verify authentication, and check repository health.
Usage
terminal
$
What It Checks
Authentication
- Valid session token
- Token expiration
- Correct permissions
Repository Registration
- Repository is registered with SageOx
- Local configuration matches server
- Repository exists on platform
Context Injection
- Context injection is configured
- CLAUDE.md and context files are set up
- Context can be retrieved from server
Output
| Symbol | Meaning |
|---|---|
[OK] | Check passed |
[WARN] | Non-critical issue |
[FAIL] | Critical issue |
ox doctor
SageOx Doctor
=============
Authentication
[OK] Logged in as user@example.com
Repository
[OK] Repo registered: my-project
Context Injection
[OK] Context injection enabled
All checks passed.
Verbose Mode
terminal
$
Shows config paths, API endpoints, and full server responses.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | All checks passed |
| 1 | One or more checks failed |
Common Issues
Not Authenticated - Run ox login
Repository Not Registered - Run ox init
Expired Token - Run ox login