Free · Open Source · Runs Locally

Generate AI context files
from any codebase.

repoDNA scans your project with a local Ollama model and writes the structured context file your AI coding assistant needs — so every session starts with full project understanding.

Get Started View on GitHub

terminal

$ git clone https://github.com/BogdanVasaiu/repodna

$ cd repodna && node main.mjs

Node.js 18+

Ollama Windows · macOS · Linux

How it works

Five steps. One command to start.

The interface guides you through every decision. No config files, no CLI flags — just a clean wizard in your browser.

Check your environment

repoDNA verifies that Node.js and Ollama are running before anything else. If either is missing, the interface shows exactly what to install for your platform — you are never left guessing.

node main.mjs — that is it

assets/step-01.png

Add your projects

Register one or more local project paths with an optional description. The description helps the AI understand the purpose of the codebase before it even starts reading files. Projects are saved across sessions.

Saved · remembered across sessions

assets/step-02.png

Select what to scan

An intelligent algorithm examines your project structure and suggests which folders and file types are safe to exclude — node_modules, build artifacts, generated files. You review and confirm. Custom rules are remembered per project.

Smart defaults · user overrides always win

assets/step-03.png

Configure the analysis

Choose the Ollama model, set analysis depth, and decide whether to skip files unchanged since the last run. A model table shows community-tested options ranked by quality, speed, and hardware requirements.

Smart Update · only re-analyzes changed files

assets/step-04.png

Watch it run — then use the output

A live progress panel shows each file being processed, its markdown content appearing in real time, and a running log. If a file fails, retry it individually. The output is written directly to your project root.

Live preview · retry per file · saved to project

assets/step-05.png

Features

Built for real projects.

Not a wrapper around a cloud API. repoDNA runs entirely on your hardware, respects your privacy, and handles the edge cases that matter.

Fully local and private

All analysis runs through Ollama on your own machine. No data leaves your environment, no cloud API is called, no account needed. Your codebase stays yours.

Adaptive precision

Four analysis depths — Fast, Standard, Deep, and Adaptive. In Adaptive mode the engine auto-selects depth per file based on size and complexity, so small files are cheap and large ones get thorough coverage.

Smart file classifier

Detects your project type — Node, Python, Rust, Go, and more — and applies sensible defaults: skip node_modules, skip build output, skip binaries. Every decision is visible and overridable.

Smart Update

An MD5 hash cache tracks every analyzed file. On subsequent runs only added, modified, or deleted files are re-analyzed. Large codebases stay fast after the first scan.

Multi-agent output

Select your AI coding tool and repoDNA writes the correct format — CLAUDE.md, .cursorrules, .windsurfrules, AGENTS.md, and more. One scan, the right file for your workflow.

Cross-platform

Works on Windows, macOS, and Linux. Requires only Node.js 18 and Ollama. No Docker, no native builds, no platform-specific setup.

Output formats

Works with the tools you already use.

Pick your AI assistant before the run. repoDNA writes the context file in the exact format and location that tool expects.

Claude Code

CLAUDE.md

Cursor

.cursorrules

Copilot

copilot-instructions.md

Gemini CLI

GEMINI.md

Windsurf

.windsurfrules

Codex CLI

AGENTS.md

Cline

.clinerules/

Roo Code

AGENTS.md

Amp

AGENT.md

OpenCode

AGENTS.md

OpenClaw

AGENTS.md

Generic

AGENTS.md

Claude Code

CLAUDE.md

Cursor

.cursorrules

Copilot

copilot-instructions.md

Gemini CLI

GEMINI.md

Windsurf

.windsurfrules

Codex CLI

AGENTS.md

Cline

.clinerules/

Roo Code

AGENTS.md

Amp

AGENT.md

OpenCode

AGENTS.md

OpenClaw

AGENTS.md

Generic

AGENTS.md

The agent list grows with every release. — Open an issue if your tool is missing.

Get started

Running in under a minute.

Two dependencies. One command. The rest is handled by the UI.

Clone the repository

Download repoDNA from GitHub to any folder on your machine.

Start the app

Run node main.mjs in the folder. The UI opens in your browser automatically.

Follow the wizard

The interface checks your environment, walks through project setup, and runs the analysis — all in one guided flow.

Requirements

Node.js v18 or later · nodejs.org

Ollama Any version · ollama.com · free

Windows macOS Linux

Terminal

$ git clone https://github.com/BogdanVasaiu/repodna

$ cd repodna

$ node main.mjs

No npm install, no build step. All dependencies are part of Node.js or loaded on demand by the app.

Remove all cached data

$ node uninstall.mjs --yes

Stop writing context files by hand.

repoDNA is free, open source, and runs entirely on your machine. Your code stays yours.

View on GitHub

Generate AI context files from any codebase.

Five steps. One command to start.

Built for real projects.

Fully local and private

Adaptive precision

Smart file classifier

Smart Update

Multi-agent output

Cross-platform

Works with the tools you already use.

Running in under a minute.

Generate AI context files
from any codebase.