Skip to main content

Doctor

elanous doctor tells you what this machine still needs. It never changes anything unless you ask it to.

elanous doctor

What it reports​

  1. 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 as elanous login openai-codex).
  2. Tools — the external commands elanous calls (rg, git, python3, ssh, …) and whether each is on PATH. See External commands.
  3. Readiness — one line per check, each ending in ok, manual, or a problem, with the fix at the end of the line. Checks include:
CheckWhat it looks at
provider-decisionWhich LLM provider is configured
gh-authWhether gh auth status succeeds (needed for pull requests)
harness-toolsrg, codex and node on PATH
install-pathWhether you run an installed copy or a checkout
service-versionWhether the background service runs the same version as this copy
bun-versionWhether your Bun matches the tested version
service-file · service-secretsThe service definition uses a stable path and carries no provider keys
build-toolchain · node-ptyThe compiler and the terminal library load
python-envThe Python environment and its required modules
docker · kubernetes · memoryOptional 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)
OptionWhat it does
--fixShow reversible repairs; read-only on its own
--yesApply the planned repairs (with --fix)
--sudoAlso run the planned sudo install lines, only where sudo -n true works (with --fix --yes)
--restartRestart the background service when it runs a different version than this copy, then verify it (with --fix --yes; interrupts bots, terminals and running turns)
--jsonStructured 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.