git404hub

what is ravel fr?

12vault/ravel — explained in plain English

Analysis updated 2026-05-18

3GoAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

Ravel is a Go command line tool that builds a local, offline knowledge graph of a codebase so developers and AI coding agents can find relevant files and trace connections without rescanning everything.

vibe map

mindmap
  root((ravel))
    What it does
      Builds local knowledge graph
      Works offline
      Single Go binary
    Tech stack
      Go
      Tree-sitter
      CLI
    Use cases
      Code search
      Agent context
      Change impact check
    Audience
      Developers
      Coding agents

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Build a searchable local knowledge graph of a codebase so an AI coding agent can find relevant files without scanning everything.

VIBE 2

Audit which files a tool will read before running any analysis to keep secrets and dependencies out of scope.

VIBE 3

Search a graph for a specific function, type, or package and trace how it connects to the rest of the code.

VIBE 4

Check what code might be affected before making a change in a shared package.

what's the stack?

GoTree-sitterCLI

how it stacks up fr

12vault/ravelalexremn/finalizer-doctorazer/diskwhere
Stars333
LanguageGoGoGo
Setup difficultyeasyeasyeasy
Complexity2/53/51/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install a prebuilt binary or build from source with Go 1.26.5 or newer, no other dependencies.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

Ravel is a command line tool, written in Go, that builds a local knowledge graph out of a codebase so both developers and AI coding assistants can understand a project without reading every file from scratch. It ships as a single binary with no Python runtime needed, and it runs entirely offline. After installing it, a person runs a build command inside a repository and Ravel creates a local graph that captures which files, functions, and types exist and how they connect to each other. The tool separates what it is confident about from what it is guessing. Facts pulled directly from parsing the code are labeled extracted, matches based on naming patterns are labeled inferred, and anything unresolved stays unresolved rather than being presented as fact. There is an optional feature where an AI agent can add extra context, such as a description of the system's architecture or a suggested reading tour through the code, but this enrichment is always marked separately from the parser's own output so a reader can tell which parts came from code analysis and which came from an agent's interpretation. Before Ravel reads anything, it runs an audit step that shows exactly which files it plans to look at, and it is built to automatically skip secrets, dependency folders, and files a project has chosen to ignore. Once a graph exists, a user can search it for a specific file, package, type, function, or method, or ask a natural language question and get back a compact, connected answer built from the graph rather than a fresh scan of the whole repository. Ravel also plugs into AI coding assistants such as Codex, Claude, Cursor, and several others through an installable skill bundle, so those tools can query the graph before searching a repository broadly, and check what a change might affect before it is made. It supports Go with deep analysis and many other languages through Tree-sitter grammars. It is released under the MIT license. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Explain how Ravel labels facts as extracted, inferred, or unresolved when building a code graph.
prompt 2
Walk me through installing Ravel and building my first local knowledge graph with ravel build.
prompt 3
How do I use ravel context to ask a natural language question about my codebase?
prompt 4
What does ravel audit check before Ravel reads my repository's files?

Frequently asked questions

what is ravel fr?

Ravel is a Go command line tool that builds a local, offline knowledge graph of a codebase so developers and AI coding agents can find relevant files and trace connections without rescanning everything.

What language is ravel written in?

Mainly Go. The stack also includes Go, Tree-sitter, CLI.

What license does ravel use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is ravel to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ravel for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.