👨‍⚕️ Doctor

In a Nutshell

Inspect the host environment and capture a support report with acorn doctor.

Start broad, then narrow the diagnostic category:

acorn doctor
acorn doctor --check software
acorn doctor --check system,memory,network
acorn doctor --report > acorn-doctor.json

--fix is exposed by the CLI but currently returns an “Autofix is not implemented yet” error. --fix --interactive opens the Doctor screen when ACORN was built with TUI support; use the diagnostic and report commands above for non-interactive environments.

Rescue: ACORN cannot find Chrome

PDF export needs Chrome or Chromium. Point ACORN at an existing executable instead of relying on automatic discovery:

# Linux
acorn --offline export index.json --format pdf \
  --chrome-path /usr/bin/google-chrome-stable

# macOS
acorn --offline export index.json --format pdf \
  --chrome-path "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

On Windows, pass the executable path with --chrome-path or set CHROME_PATH. Connected export can download ACORN’s pinned browser; offline export needs a configured, installed, or already cached browser. See Chrome selection.

Rescue: offline mode unexpectedly fails

Global --offline forbids network reads; it does not turn remote inputs into local ones. Check these common causes:

1. Replace HTTP(S) inputs and model-list URLs with local paths or file:// URIs.
2. Use check --skip prose if analyzer extensions have not already been synchronized.
3. Configure --chrome-path or cache the pinned browser before offline PDF export.
4. Do not combine gather --resolve, gather --merge-request, or gather --osti with offline mode.

Run the failing command with -vv to expose the resource ACORN attempted to resolve.

Rescue: a model sync target is not detected

With no target flags, acorn sync selects applications whose commands it detects. Request a target explicitly to make the decision visible:

acorn sync --vscode --dry-run
acorn sync --vscode --force --dry-run

--force bypasses command detection only for targets you explicitly include. If the application is detected but weights are elsewhere, set --models-dir; use --assume-models only when another system guarantees those paths exist. Continue with the Sync troubleshooting guide.

Next stop: Preview application routing with Sync.