Open Source · No API Keys · Easy to Use

Generate AI context files
from any codebase.

Every new AI session starts with no memory of your project. You end up re-explaining the same things every time. repoDNA fixes this — it scans your codebase and generates the context file your assistant reads at startup, so it already understands your project from the first message.

terminal
$ git clone https://github.com/BogdanVasaiu/repodna
$ cd repodna && node main.mjs
Node.js Node.js 18+ to start Ollama Ollama guided by the UI Windows · macOS · Linux
GitHub Stars
12+ AI Agents Supported
4 Precision Modes
0 API Keys Required

See it in action.

A short video series covering installation, setup, and real-world usage.

This video can't be embedded.

Watch on YouTube
Episode 1

Episodes

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.

01
Ollama setup

Checks whether Ollama is running and lists all locally installed models. If Ollama is missing, the interface shows the exact install command for your platform. A curated model reference table lets you compare and pull the right model before starting — ranked by quality, speed, and VRAM requirements.

Ollama · model reference · pull from UI
Setup step
02
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.

Multiple projects · per-project description
Projects step
03
Select what to scan

repoDNA detects your project type and pre-selects what to scan. Dependencies, build output, and binaries are automatically excluded. Every decision is visible in the file tree — you can override anything, per file or per folder. Your custom rules are saved and reused on the next run.

Smart defaults · user overrides always win
File selection step
04
Configure the analysis

Choose the Ollama model from your installed list, set the analysis depth, and configure advanced options: Smart Update to skip unchanged files, and an optional file tree embedded in the output.

Smart Update · file tree · precision modes
Options step
5.1
Pick your context file target

Choose which AI agent's context file format to generate — CLAUDE.md, AGENTS.md, .cursorrules, Copilot instructions, and more. RepoDNA writes the right file in the right place for each agent you ship to.

Claude · Cursor · Copilot · Codex · Gemini · 12+ agents
Context file selector
5.2
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. Each result can also be edited safely from the UI — changes are saved to the cache and the output is rebuilt from there, never by re-reading your project files.

Live preview · retry · edit from UI · cache-safe
Run step

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.

No API keys, no accounts

Analysis runs through Ollama — locally on your machine, or on any remote machine you control. No proprietary cloud API, no account needed, no data sent anywhere you didn't choose.

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.

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.

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

Running in under a minute.

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

1
Clone the repository

Download repoDNA from GitHub to any folder on your machine.

2
Start the app

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

3
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.
Update to latest version
$ node update.mjs
Remove all cached data
$ node uninstall.mjs
Show all commands & flags
$ node help.mjs

Stop writing context files by hand.

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

View on GitHub