agentstack doctor
Synopsis
Section titled “Synopsis”agentstack doctor --profile-file <path>Description
Section titled “Description”The doctor command validates a canonical agentstack.yaml profile against the v3 schema. It reports errors, warnings, and suggestions covering:
- Schema validation (required fields, correct types)
- MCP server configuration (valid commands, reachable sources)
- Skill sources (local files exist, remote URLs are valid HTTPS)
- Provider settings (enabled providers have valid configs)
Options
Section titled “Options”| Flag | Type | Required | Description |
|---|---|---|---|
--profile-file <path> | string | Yes | Path to the agentstack.yaml to validate |
Examples
Section titled “Examples”Validate the default profile:
agentstack doctor \ --profile-file ~/.agentstack/profiles/main/agentstack.yamlValidate a local profile file:
agentstack doctor --profile-file ./agentstack.yaml