> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conquoreum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common Reality Harness problems and how to fix them.

| Symptom                                              | Cause                                                                            | Fix                                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Everything shows as **unassigned** (Level 3)         | Tasks have no `skill/<category>` tag                                             | Tag them, or run the backfiller — see [Level 3](/reality-harness/level-3-board-sync)                 |
| **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](/api-keys/rotating-and-revoking)        |
| 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](/reality-harness/level-3-board-sync)                            |
| **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](/reality-harness/level-3-board-sync)    |
| 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](/reality-harness/environment-variables) |