---
title: doctor
description: Run diagnostics on your mem/ctl setup
---

# memctl doctor

Checks your configuration, connectivity, and permissions.

```bash
npx memctl doctor
```

## Checks 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 auth` or set `MEMCTL_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
