CLI Reference
doctor
Run diagnostics on your mem/ctl setup
memctl doctor
Checks your configuration, connectivity, and permissions.
npx memctl doctorChecks performed
| Check | What it verifies |
|---|---|
| Token present | MEMCTL_TOKEN is set or available in config |
| Org slug present | MEMCTL_ORG is set |
| Project slug present | MEMCTL_PROJECT is set |
| API reachable | Can connect to the API URL |
| Token valid | Token authenticates successfully |
| Org accessible | Token has access to the specified org |
| Project accessible | Token has access to the specified project |
| Memory capacity | Current usage and limit |
Example output
memctl doctor
✓ Token present
✓ Org slug present
✓ Project slug present
✓ API reachable
✓ Token valid
✓ Org accessible
✓ Project accessible
✓ Memory capacity: 42/500 (8.4%)
All checks passed.Common failures
- Token not present - run
npx memctl author setMEMCTL_TOKEN - API not reachable - check network, firewall, or
MEMCTL_API_URL - Token invalid - regenerate token in the dashboard
- Org/project not accessible - verify slugs match dashboard URLs