Doctor
elanous doctor tells you what this machine still needs. It never changes anything unless you ask it to (the one exception: with --fix on a terminal it may offer to install git, and waits for your answer).
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 |
bun-tmpdir | TMPDIR and Bun's cache are on the same filesystem (Linux) |
The last line counts what is left to do.
Fixing things
elanous doctor --fix # show the repairs it would make
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. On a terminal it may offer to install a missing git; everything else needs --yes |
--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) |
--credentials | Show details for each credential in the normal output |
--advise | Ask your configured model to rank the suggested repairs (advice only; changes nothing) |
--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.