reekta92

reekta92 / graf

Public

A TUI graph view for markdown files with wikilinks. Customizable.

45
4
100% credibility
Found May 06, 2026 at 45 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Terminal-based interactive graph visualizer that maps connections in markdown notes using wikilinks and frontmatter.

How It Works

1
🗺️ Discover graf

You hear about graf, a simple way to turn your scattered notes into a visual map of ideas and connections.

2
📥 Get it ready

Download graf and place it on your computer so it's easy to use anytime.

3
📁 Open your notes folder

Navigate to the folder holding your markdown notes full of links between ideas.

4
✨ Watch the magic unfold

Start graf and see your notes spring to life as a beautiful, moving web of connected dots you can explore.

5
🔍 Dive in and play

Zoom around, search for notes, drag nodes, and click to open files right in your favorite editor.

6
🎨 Make it yours

Pick colors, toggle maps or grids, and adjust the look to feel just right for your eyes.

🎉 Unlock your knowledge

Now you effortlessly spot patterns, hidden links, and jump between ideas in your personal wiki.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 45 to 45 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 graf?

Graf turns your markdown notes into an interactive force-directed graph right in the terminal. Drop into a directory with .md or .mdx files using wikilinks like [[Note]] or frontmatter titles/tags, run `graf`, and explore a pannable, zoomable network of connections. Built in Rust with Ratatui, it parses links recursively, supports fuzzy search via 'f', and opens files in your $EDITOR on Enter or double-click.

Why is it gaining traction?

In the world of GitHub TUI apps and TUI markdown tools, graf delivers Obsidian-style graph views without leaving the terminal—perfect for SSH or tmux. Standout user perks include 11 themes (Tokyo Night, Gruvbox), minimap, legend, grid overlays, and deep config via TOML/CLI/env vars like node colors by tag/folder/link count. Mouse panning, node dragging, and 60fps physics make navigation fluid, outshining basic TUI graph viewers.

Who should use this?

Terminal-first note-takers building markdown wikis or Zettelkasten systems who want visual link maps without GUI bloat. Obsidian users seeking a CLI companion for remote servers, or Rust devs prototyping knowledge graphs in plain text files. Ideal for PKM workflows where quick scans reveal note clusters by tags or folders.

Verdict

Try graf if terminal graphs fit your flow—features are polished, docs comprehensive, install via Cargo. With 45 stars and 1.0% credibility, it's early (bugfix phase before merging into clin-rs), so report issues; not production-ready for huge vaults yet.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.