Troubleshooting Matrix

Symptom Likely cause Fix
Error: not a git repository during run/diff command requires git workspace context run from a git repo, or initialize one with git init
Doctor shows API key source: none missing env var and no local secret run hexi onboard or export provider key
Run fails with parse error model output did not match ActionPlan schema narrow prompt and validate with hexi plan-check
Command blocked command missing from allowlist or blocked base command tighten prompt or add minimal allowlist entry
No file changes after run plan contained only read/list/search/emit actions request explicit write action in task