Gabriella439

Gabriella439 / semantic-navigator

Public

Semantic project navigation

140
13
100% credibility
Found Feb 17, 2026 at 61 stars 2x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A command-line tool that semantically clusters and labels files in a directory or Git repository using AI embeddings, displaying an interactive tree view in the terminal.

How It Works

1
📖 Discover the tool

You come across a blog post raving about a handy way to browse your project's files grouped by their actual meaning, not just folders.

2
🔗 Connect AI helper

You link up a smart AI service so the tool can understand and label what your files are about.

3
📁 Pick your project

You point the tool at the folder holding all your files, like a code project or documents.

4
⚡ Magic organization happens

Sit back as it reads everything and smartly groups similar files into neat clusters with meaningful labels, feeling like your project just got a brain.

5
🌳 Open the interactive map

A beautiful tree view pops up in your screen, showing clusters nested by purpose, with file counts and patterns.

🎉 Navigate by meaning

Effortlessly expand branches to explore files grouped intuitively, making it super easy to grasp the big picture of any project in seconds.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 61 to 140 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 semantic-navigator?

Semantic-navigator is a Python CLI tool that scans any text-based repository—code or docs—and builds an interactive tree viewer clustering files by semantic meaning using OpenAI embeddings. Point it at a Git repo or directory with `semantic-navigator /path/to/repo`, and it generates human-readable labels for clusters, like "Condition Rendering" for related files, handling up to 10,000 files in minutes. It solves the pain of path-based navigation in large projects, letting you browse by intent via a Textual-powered TUI.

Why is it gaining traction?

It stands out from ls-tree or ripgrep by using semantic search project techniques to group files intelligently, uncovering hidden structures like shared patterns in github semantic commit messages or unrelated docs. Devs hook on the instant "aha" of nested clusters with auto-labels from gpt-4o-mini, faster than manual grep in unfamiliar semantic web projects github repos. Nix and uv one-liners make it dead simple to spin up, no setup hassle.

Who should use this?

Onboarding engineers diving into massive monorepos, like Haskell or self-hosted blogs, where file paths mean nothing. Architects auditing legacy code for semantic priming project overlaps. Solo devs prototyping semantic projector tools or semantic reader project explorations on their own github semantic release setups.

Verdict

Try it for quick semantic text navigator wins on mid-sized repos, but with 44 stars and 1.0% credibility score, it's early alpha—solid README and Nix/uv docs, no tests yet. Pair with semantic github action workflows once it matures.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.