Skip to content

CLI Extensions Doctor

github-actions[bot] edited this page Aug 24, 2026 · 4 revisions

ed extensions doctor

Diagnoses setup and runtime problems for one extension or all seventeen.

ed extensions doctor [<id>] [--json]

Without an id, the human form prints a detailed report for every extension in registry order and the JSON form is an ordered array. With an id, JSON is one report object. doctor uses the same probe and JSON report as status and verify.

Checks cover the stored enabled state, required and optional permissions, required and optional tools, helper availability, platform capabilities, configured machines and supported backend or session health. Checks that do not apply are omitted, and checks behind a disabled extension are skipped. All seventeen extensions have an explicit live adapter. A missing adapter is reported as a runtime error instead of silently falling back to helper availability.

ed extensions doctor
ed extensions doctor herdr
ed extensions doctor --json | jq '.[] | select(.state.phase == "failed")'

An unhealthy extension exits 0 with verified: false. This makes the command safe for noninteractive agents that need the full remediation plan.

Where to go next

CLI reference

Getting Started
Config
App
Extensions
Permissions
Usage
System
Music
Calendar
Clipboard
Color
Download
Apps
Tools
Shelf
Cleaner
Machines
Machines Remote
Machines Docker
Machines Files
Machines Power
Machines Workspace
Attention
Companion
Herdr
Lid Awake
Machines Terminal
Machines Thermal

Guides

Clone this wiki locally