Troubleshooting
Use this page when something blocks you. Still stuck? Email support@raaghu.ai.
Access and authorization
Access request pending — "Request submitted. Retry authorization after admin approval"
Ask an org admin to approve you in Access Requests, then click Authorize Now again. See Access Requests.
Access denied or approved but still blocked — Contact an org admin. If you were already approved, ask them to assign a seat next (Azure DevOps → Organization settings → Raaghu Spec Kit → Users).
Authorize fails / popup blocked — Allow popups for Azure DevOps, try another browser, and retry.
On-prem "Setup Required" — Complete Server Deployment Setup, then authorize. Cloud users should not see this.
On-prem email OTP — Enter your work email and the 6-digit code. See Installation and Launch.
Seats and subscription
"You need a seat" / not subscribed / trial ended — Org admin opens Organization Settings, completes checkout if needed, and assigns seats on Users.
If the hub shows "Your organization is not subscribed to Raaghu Spec Kit", click Open org settings (admins) or ask an admin to subscribe:
Canceling / undo — On Subscription, use Undo cancellation or Undo seat change while a change is still pending.
AI and chat
LLM not configured — Hamburger → Settings. Add BYOK credentials, or ask an admin to enable Raaghu-hosted AI and top up credits. See Settings.
Hosted balance empty — Admin tops up on Organization Settings → Subscription → Top up Credits.
Unexpected command names — Check Settings → Commands Mapping (Default vs Spec Kit). Friendly names such as "Create Specification" are the same as /speckit.specify. See Spec Kit Commands.
Provider / rate limit errors — Wait and retry; check provider quota or credit balance.
Initialize and Wiki
Initialize fails — Confirm project Wiki access, wiki write permission, and network access to GitHub.com. See Initialize Spec Kit.
Cannot find Speckit files — Look for the Speckit root in Wiki. If missing, initialize again.
Dashboard and Visual
Empty Dashboard — Select the correct iteration. Complete Your First Feature so artifacts exist.
Visual Sync disabled — Confirm constitution/spec/tasks exist, AI is configured, and you have work-item create permission. Sync one level at a time. See Visual.