1. Your Obsidian board
The bridge looks for markdown notes under<your vault>/10-PM/**/*_tasks/*.md. Each note needs YAML frontmatter:
| Field | Required? | Notes |
|---|---|---|
pm-task | Yes | must be the literal boolean true |
id | Yes | stable unique id |
projectId | Yes | the parent project’s id |
project | Yes | human-readable project name |
title | Yes | task title |
type | Yes | e.g. task |
status | Yes | one of todo · in-progress · blocked · review · done · closed |
kind | No | set to day to appear in the daily checklist |
priority | No | critical · high · medium · low — sets XP weighting |
start / due | No | YYYY-MM-DD |
tags | No | carries the skill tag (below) |
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 four skill lanes:leadership · business-acumen · technical-skills · content. Tag a task with skill/<category> in its tags list:
unassigned bucket and earns 0 XP. Tag your tasks — this is the one thing to get right.
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.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, defaults off) that discards even allowlisted data until you opt in. Turn it on in the app under Privacy / Connected Apps.
| Preference | Default | Effect |
|---|---|---|
syncEnabled | off | master switch — off means the server stores nothing |
shareWithCompanion | off | lets your Companion see your open day tasks |
hideTaskTitles | on | when shared, sends status only — titles stay private |
perSkillShare | none | which skill lanes your Companion may see |
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. Expect up to one poll interval of delay. Reopening a completed task never claws back XP.Free tier: connect 1 folder. Premium tier: unlimited folders + bonus features. Manage your subscription in the iOS app under Settings.