xlflow doctor

Diagnose Excel, COM, PowerShell, VBIDE access, workbook access, and GUI-boundary prerequisites.

Usage

xlflow doctor [--keepalive] [--keepalive-interval <duration>]

Options and Arguments

Option / argument	Description	Default
--keepalive	Keep the Excel bridge process alive across checks.	false
--keepalive-interval <duration>	Bridge keepalive interval such as 30s.	command default
--json	Return structured diagnostics for agents and CI logs.	false

Examples

xlflow doctor
xlflow doctor --keepalive --json

Notes

TIP

Run doctor before debugging workbook behavior on a new Windows or Excel installation.

WARNING

VBIDE access must be enabled in Excel Trust Center before xlflow can import, export, or inspect VBA components.

JSON Output Example

Successful --json output uses the xlflow envelope plus command-specific fields.

{
  "status": "ok",
  "command": "doctor",
  "checks": [
    { "name": "excel_com", "status": "ok" },
    { "name": "vbide_access", "status": "ok" }
  ]
}

Related

• check
• troubleshooting
• environment variables