---
title: "ay doctor"
source: "https://ayoune.com/en/docs/cli/ay-doctor"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:25:12.079Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay doctor`

Diagnostik-Tool: prüft die lokale CLI-Installation + Environment + Connectivity in einem Rutsch.

## Aufruf

```bash
ay doctor
```

## Checks

| Kategorie | Check |
|---|---|
| **Runtime** | Node ≥ 20, npm ≥ 10 |
| **Installation** | CLI-Version aktuell (latest verfügbar?) |
| **Config** | `~/.config/ayoune/config.json` vorhanden + valides JSON |
| **Session** | JWT vorhanden + gültig (expires_at future) |
| **Token-Refresh** | Refresh-Token-Ring OK |
| **Connectivity** | HTTP/HTTPS zu allen konfigurierten Hosts (api, auth, support-api, cm, bc, …) |
| **Customer-Context** | Aktiver Context noch gültig (Customer nicht gelöscht) |
| **Editor** | `$EDITOR` existiert im PATH |
| **Completion** | Shell-Completion installiert? |
| **File-Permissions** | `~/.aYOUne/storage/*` 0600 |

## Output-Format

```
✔ Node v20.11.1
✔ CLI version 2026.17.0 (latest)
✔ Config valid
✔ Session active (expires in 42m)
✔ Token refresh ring healthy
✖ api.ayoune.app unreachable (DNS timeout)
✔ auth.ayoune.app OK (103ms)
✔ support-api.ayoune.app OK (87ms)
⚠ Editor $EDITOR not set, falling back to 'nano'
✔ Completion installed for bash
✔ Storage file permissions OK

2 issues found:
  - api.ayoune.app unreachable
  - $EDITOR not set (non-blocking)

Exit: 1
```

## Exit-Codes

| Code | Bedeutung |
|---|---|
| 0 | Alle Checks grün |
| 1 | Mindestens ein Error (blockierend) |
| 2 | Nur Warnings |

## CI-Integration

```bash
ay doctor && npm run build       # nur bauen wenn Doctor OK
ay doctor --json > health.json   # CI-Reporting
```

## Siehe auch

- [status](wiki:cli/devops/status) — Platform-Health-Check (serverseitig)
- [Troubleshooting](wiki:cli/troubleshooting)

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com