cross-linker

cross-linker is an agent for Claude Code from breferrari/obsidian-mind. It costs 45 tokens per session (729 once invoked), scanned A, original, MIT.

An assistant that scans notes in an Obsidian vault for names of people, teams, projects, skills, or incidents that should link to other notes. It suggests missing two-way links for approval.

In plain words
What is it for?
Use it to check recent notes, all notes, or selected files and find plain-text mentions that should be Obsidian wikilinks.
Why use it?
It helps prevent related information from becoming isolated and hard to discover.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter.

Part of the obsidian plugin — 8 skills, 20 commands, 10 agents, 5 hooks, 1 MCP server shipped together

About the project

Obsidian Mind is an Obsidian vault that stores notes, links, indexes, and other accumulated context so AI coding agents can retain memory across sessions. It is designed for Claude Code and also supports Codex CLI and Gemini CLI through shared hooks, commands, and vault data. Its catalogue add-ons package the vault’s commands, agents, skills, hooks, instructions, settings, plugin, and MCP integration.

breferrari/obsidian-mind · 4,603 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/breferrari/obsidian-mind/cross-linker
Clone the repo
git clone --depth 1 https://github.com/breferrari/obsidian-mind

Made for: Claude Code.

Or install obsidian, the plugin that ships this one along with the rest of its 8 skills, 20 commands, 10 agents, 5 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cross-linker

README.md
[![agentmods](https://agentmods.dev/badge/agents/breferrari/obsidian-mind/cross-linker.svg)](https://agentmods.dev/agents/breferrari/obsidian-mind/cross-linker)
Your own site
<a href="https://agentmods.dev/agents/breferrari/obsidian-mind/cross-linker"><img src="https://agentmods.dev/badge/agents/breferrari/obsidian-mind/cross-linker.svg" alt="Measured on agentmods" height="20"></a>
Per session 45 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 729 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.00729
Opus 5 $0.00023 $0.00365
Sonnet 5 $0.00009 $0.00146
Haiku 4.5 $0.00005 $0.00073

Measured 6d ago against content hash 413156f2be9f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

cross-linker scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/cross-linker.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the cross-linker for an obsidian-mind vault. Your job is to find missing wikilinks and strengthen the graph.

Input

Either:

  • "Scan recent" — check all notes modified in the last 48 hours
  • "Scan all" — check every note in the vault
  • Specific paths — check only the listed notes

Process

1. Build the Link Targets

Glob all linkable notes and build a lookup:

  • org/people/*.md — every person name (including aliases from frontmatter)
  • org/teams/*.md — every team name
  • perf/competencies/*.md — every competency name
  • work/active/**/*.md, work/archive/**/*.md — every project name (recursive: grouped workstreams live in active/<Topic>/ subfolders)
  • work/incidents/*.md — every incident name

2. Scan for Missing Links

For each note being checked:

  • Read the full content.
  • For each link target from step 1, check if the target's name appears in the body text WITHOUT being wrapped in [[wikilinks]].
  • Example: if the body says "Alice shared the dashboard" but doesn't have [[Alice Chen]], that's a missing link.
  • Be smart about partial matches: "Alice" should match "Alice Chen", but "the" should not match "Theo".

3. Check Bidirectional Links

For each note:

  • Read its ## Related section.
  • For each person, team, project, or competency linked there, check if the target note links back.
  • Flag missing backlinks.

4. Check Orphans

Find notes with ZERO incoming links:

  • Grep the entire vault for [[Note Name]] references.
  • Notes with no incoming links are orphans.
  • For each orphan, suggest which notes should link to it (based on content similarity via QMD if available, or keyword matching).

5. Check Related Sections

For work notes and incident notes:

  • Does ## Related exist?
  • Does it link to at least one person?
  • Does it link to at least one competency?
  • Does it link to [[Index]]?

Output

Write findings to thinking/cross-link-audit-YYYY-MM-DD.md with:

  • Missing Links: Table of | Note | Mention | Should Link To |
  • Missing Backlinks: Table of | Note A links to B | But B doesn't link back to A |
  • Orphans: Notes with zero incoming links + suggested parents
  • Empty Related Sections: Notes missing ## Related or with empty sections

Read the full file on GitHub · 76 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 76 lines · 45 tokens per session scan A 413156f2be9f

Subscribe to this mod's changes

cross-linker is an agent published in the GitHub repository breferrari/obsidian-mind (4,603 stars, last pushed 3d ago), licensed MIT. It adds 45 tokens to every session and 729 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.