AgentDoctor CLI
Use agentdoctor to diagnose missing host capabilities before a workflow starts or immediately after a dependency-related failure.
Invoke the Tool
Prefer the installed binary when it exists:
agentdoctor -profile smb-client -format text
If working inside this repository or the binary is not installed, run:
go run ./cmd/agentdoctor -- -profile smb-client -format text
Choose Profiles
- Use
-profile smb-clientwhen a workflow needs SMB or CIFS access to a Windows host or share. - Use
-profile ssh-clientwhen the task depends on SSH or SCP. - Use
-profile web-fetchwhen the task depends oncurlor PowerShell HTTP support. - Use repeated
-cmdflags for custom one-off dependency checks.
Apply Good Defaults
- Keep
-strict=truefor startup and health checks so missing tools fail early. - Use
-format jsonwhen another agent step will branch on the result. - Use
-strict=falsewhen the task only needs advisory diagnostics. - Prefer
agentdoctorover a blind failing connection attempt when the problem may be “tool missing” rather than “credentials wrong.”
Examples
Diagnose the SMB client case:
go run ./cmd/agentdoctor -- -profile smb-client -format text
Check a custom command set:
go run ./cmd/agentdoctor -- -cmd git -cmd curl -format json