azuma520

azuma520 / obsidian-graph-query

Public

Let your AI agent query your Obsidian vault's knowledge graph directly.

17
0
100% credibility
Found Mar 08, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

This project provides a skill for AI agents to analyze and query the link structure of notes in an Obsidian vault using everyday language questions.

How It Works

1
📚 Hear about the helper

You learn about a tool that lets your AI explore the connections in your Obsidian notes.

2
⬇️ Add it easily

Use one quick command to bring this skill into your AI assistant's toolbox.

3
🤖 AI sets it up for you

Chat with your AI saying 'help me set up' and it guides you to link your note collection smoothly.

4
💭 Ask natural questions

Simply tell your AI what you want to know, like 'which notes link to the most others?'

5
📊 Discover hidden patterns

Your AI shares clear tables, paths between ideas, lists of lonely notes, and network weak spots.

6
📈 Request a full overview

Ask for a complete report on your notes' structure, trends, and risks.

✅ Master your notes

You now see the big picture of your knowledge, reconnect forgotten ideas, and build a stronger web of thoughts.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is obsidian-graph-query?

This Shell-based skill lets AI agents like Claude Code or GitHub Copilot query your Obsidian vault's knowledge graph directly via natural language. Ask "which notes have the most links?" or "how are Note A and Note B connected?" and it runs graph algorithms through Obsidian's CLI to deliver results like top hubs, shortest paths, orphan notes, and full vault reports. It solves the problem of Obsidian's static graph view, turning vague visuals into quantifiable insights for vaults with 2000+ notes.

Why is it gaining traction?

Unlike Dataview's single-note queries or graph view's manual exploration, this handles full traversals—BFS paths, bridge detection, connected components—with AI explanations, no coding needed. The hook is seamless integration: install via npx, tell your agent "help me set up," and query instantly, perfect for github let's build from here workflows where agents transform data like obsidian graph query. Early adopters love chaining queries into structured reports on structure, risks, and trends.

Who should use this?

Obsidian users with sprawling vaults who lose track of connections, like researchers mapping concepts or devs linking project notes. AI agent fans in Claude Code, Cursor, or Copilot who want let agent mode's remote browser reuse cookies between sessions for persistent vault analysis. Knowledge managers spotting orphans or bridges before they waste time.

Verdict

Try it if you match the profile—solid docs and quick setup make the 17 stars and 1.0% credibility score forgivable for such a niche tool, though expect tweaks for huge vaults. Skip if your vault is small or you avoid agent dependencies; it's raw but fills a clear gap.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.