Find missing links between notes across the full vault (zettels + GTD). Use when a note feels isolated or after adding new notes to surface bidirectional connections.
Surface missing bidirectional links for a note or set of notes across the
full vault (~/notes/).
If given an ID, find and read the note (could be in any group):
zk list --match "<id or title>" --format "{{filename}} {{title}} ({{path}})" 2>/dev/null
From the note content, identify 3–5 core concepts, terms, or claims to search against.
zk list --match "<concept>" --format "{{filename-stem}} {{title}} ({{path}})" 2>/dev/null
One search per concept. Exclude the target note itself. Results may span zettels, GTD tasks, and project dashboards.
Read each candidate note. Assess whether a link is meaningful:
Discard weak associations.
**Suggested links for [[id]] — Title:**
→ [[id]] Title (zettels/)
Reason: <one sentence why these ideas connect>
Direction: <target → candidate | candidate → target | bidirectional>
→ [[id]] Title (gtd/tasks/)
...
For each accepted link, add to the appropriate note:
## Links
- [[id]] — Title — <reason>
Always add links in both directions unless the relationship is clearly one-way.
$ARGUMENTS - Note ID, title, or topic to find connections for