1. Your Obsidian board
The bridge looks for markdown notes under<your vault>/10-PM/**/*_tasks/*.md. Each note needs YAML frontmatter:
The bridge silently skips a note missing any required field. If fewer notes sync than you expect, check for a missing field first.
For a task to show up in the daily checklist specifically, it needs both
kind: day and a due date. Every other task still syncs, still earns XP, and still feeds the skill trees; it just won’t appear in the day view.2. Tagging for skill lanes
There are five skill lanes:
Tag a task with
skill/<category> in its tags list:
priority decides how much. (Physical Training also receives XP from Apple Health workout imports, which is a separate path from board sync.)
A task with no skill lane lands in a synthetic unassigned bucket and earns 0 XP. This is the one thing to get right.
A lane is resolved in this order, first match wins:
- The
skill/<category>tag on the task. - A per-project default. Set one and every task in that project inherits the lane without needing its own tag. Set it in the iOS app, or with the
/domain-expansiontooling. - Otherwise the task is
unassignedand earns 0 XP.
skill/technical behaves as untagged rather than silently landing somewhere wrong.
If you generate tasks with Conquoreum’s task-writer tooling, tasks are auto-tagged for you based on their title and project, and any tag you already set is left alone. To retroactively tag an existing board, a one-off backfiller script scans your vault and adds the right tags (dry-run first, then --apply).
3. The board-sync bridge
A small Node/TypeScript daemon that runs on your own machine, reads your vault directly, and talks to Conquoreum’s API.VISION_API_TOKEN is a cqk_ key that needs the obsidian:sync scope. Mint it in the app under Connected Apps. A key without that scope is rejected before anything is stored.
4. Turning it on and sharing with your Companion
Board sync is off by default, even once everything above is running. Conquoreum’s server has its own master switch (syncEnabled, off by default) that discards even allowlisted data until you opt in. Turn it on in the app under Privacy / Connected Apps.
5. Ticking tasks off
Ticking a task off in the app doesn’t edit your vault instantly. The app queues the change, and the bridge (the only thing that ever writes to your vault) applies it on its next poll, so expect up to one poll interval of delay. Reopening a completed task never claws back XP.Board sync is part of the Reality Harness subscription. It is not included in the free tier or in the other subscription tiers. Without it the board routes answer
payment_required and nothing syncs. Subscribe or manage it in the iOS app under Settings.6. Reaching your board from anywhere
Once Level 3 is syncing, the board is also reachable remotely: the remote MCP endpoint lets any MCP client read your week view and tick tasks off over HTTPS with aboard:read / board:write key. A remote check-off awards XP through the same server logic and lands back in your vault on the bridge’s next poll.