| Symptom | Cause | Fix |
|---|---|---|
| Everything shows as unassigned (Level 3) | Tasks have no skill/<category> tag | Tag them, or run the backfiller — see Level 3 |
| 401 Unauthorized | Token is missing, revoked, wrong scope, or from a different environment | Mint a fresh key with the right scope from the Key Console |
| Tagged the board but it’s still unassigned | The bridge hasn’t re-synced that note yet | Force a full re-sync — see Level 3 |
| Nothing syncs at all (Level 3) | Allowlist is empty, syncEnabled is off, or you don’t have the entitlement | Add your project/tags to the allowlist; turn syncEnabled on in the app; confirm your tier |
| A task is missing from the daily checklist | Not kind: day, no due date, or a required frontmatter field is missing | Add kind: day + due; fix the frontmatter — see Level 3 |
| Your Companion can’t see your tasks | shareWithCompanion is off, or perSkillShare excludes that lane | Enable Companion sharing; add the lane to perSkillShare |
| Completing a task awards 0 XP | The task is unassigned | Tag it with a skill/<category> |
| A check-off didn’t reach your vault | The bridge isn’t running in watch mode, or the note was renamed | Run watch; re-sync the renamed note |
| MCP tools run but nothing appears in the Throne Room | CONQUOREUM_CONVEX_URL or CONQUOREUM_API_TOKEN is unset — you’re in mock mode | Set both environment variables — see Environment variables |
Troubleshooting
Troubleshooting
Common Reality Harness problems and how to fix them.