Doctor
elanous doctor tells you what this machine still needs. It never changes anything unless you ask it to.
elanous doctor
What it reports
- Credentials — for each key elanous can use (for example
OPENAI_API_KEY,XAI_API_KEY,TELEGRAM_BOT_TOKEN): whether it resolves, where it came from, which capability needs it, and the free alternative if there is one (often a subscription login such aselanous login openai-codex). - Tools — the external commands elanous calls (
rg,git,python3,ssh, …) and whether each is onPATH. See External commands. - Readiness — one line per check, each ending in
ok,manual, or a problem, with the fix at the end of the line. Checks include:
| Check | What it looks at |
|---|---|
provider-decision | Which LLM provider is configured |
gh-auth | Whether gh auth status succeeds (needed for pull requests) |
harness-tools | rg, codex and node on PATH |
install-path | Whether you run an installed copy or a checkout |
service-version | Whether the background service runs the same version as this copy |
bun-version | Whether your Bun matches the tested version |
service-file · service-secrets | The service definition uses a stable path and carries no provider keys |
build-toolchain · node-pty | The compiler and the terminal library load |
python-env | The Python environment and its required modules |
docker · kubernetes · memory | Optional container runtime, cluster and available memory |
The last line counts what is left to do.
Fixing things
elanous doctor --fix # show the repairs it would make (read-only)
elanous doctor --fix --yes # apply them
elanous doctor --fix --yes --sudo # also run the planned sudo install lines (only where sudo works without a password)
| Option | What it does |
|---|---|
--fix | Show reversible repairs; read-only on its own |
--yes | Apply the planned repairs (with --fix) |
--sudo | Also run the planned sudo install lines, only where sudo -n true works (with --fix --yes) |
--restart | Restart the background service when it runs a different version than this copy, then verify it (with --fix --yes; interrupts bots, terminals and running turns) |
--json | Structured output |
⚠️ Some headings and remedies are still printed in Korean. The check names and the ok / manual status are in English.
See also: Install · Troubleshooting.