Troubleshooting

Start with doctor

Run pnpm verify and CLI doctor first, then check Node/pnpm versions, provider environment variables, Gateway base URL, Git state, and pack smoke.

pnpm verify
node packages/cli/dist/main.js doctor --json
pnpm contract:check
pnpm pack:smoke
git status --short --branch

Doctor output

Doctor reports API key present/missing and hides real key values. Output includes Node, platform, Git, PowerShell, config sources, provider readiness, writable state directory, package manifest, startup.hub / startup.edge checks, and the doctor.agentHub aggregate.