| 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, so you’re in mock mode | Set both variables (see Environment variables) |
| 402 payment_required on a board tool (remote) | board_week / board_complete / board_reopen need the Reality Harness paid tier | Upgrade in the iOS app, or use harness_summary (not tier-gated) |
| 403 “board sync disabled” (remote) | The syncEnabled master switch is off in the app | Turn board sync on under Privacy / Connected Apps (see Remote MCP endpoint) |
Remote board_week returns blank titles | hideTaskTitles is on, so titles, projects, and tags are redacted | Turn hideTaskTitles off in the app if you want full titles over the wire |
| 429 rate_limited (remote) | Over the hourly bucket (600/hr reads, 300/hr writes) | Back off and retry after the window resets |
Troubleshooting
Troubleshooting
Common Reality Harness problems and how to fix them.