by rune-context
A lightweight, local-first repository context system that helps code LLMs understand large codebases without consuming massive amounts of tokens.
# Add to your Claude Code skills
git clone https://github.com/rune-context/runerune is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by rune-context. A lightweight, local-first repository context system that helps code LLMs understand large codebases without consuming massive amounts of tokens. It has 1 GitHub star.
rune's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/rune-context/rune" and add it to your Claude Code skills directory (see the Installation section above).
rune is primarily written in Go. It is open-source under rune-context on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh rune against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Repository Context Protocol
Git stores history. Rune stores understanding.
Rune scans your repository and generates RUNE.md — a single skill file that any AI coding agent can read to understand your codebase. No MCP server needed. No configuration. Just a file.
Works with Antigravity · Claude · Cursor · Codex · Windsurf · Copilot and any agent that reads project files.
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/rune-context/rune/main/install.sh | sh
Windows:
irm https://raw.githubusercontent.com/rune-context/rune/main/install.ps1 | iex
From source:
git clone https://github.com/rune-context/rune.git
cd rune
make install
cd your-project
rune init # Create .rune/ config
rune index # Scan and generate RUNE.md
That's it. Your AI agents will now read RUNE.md automatically.
A single, human-readable markdown file with:
Example output:
## Architecture
**24 files** · **3774 lines**
Languages:
- go (15 files)
- typescript (8 files)
Structure:
- internal/: 9 files
- cmd/: 5 files
## File Map
### cmd/
- `cmd/index.go` (go, 73 lines) → Index
- `cmd/init.go` (go, 70 lines) → Init
## Key Exports
**internal/scanner/scanner.go**
- `FileInfo`
- `Scanner`
- `New`
| Command | Description |
|---|---|
rune init |
Initialize .rune/ config |
rune index |
Full scan → generates RUNE.md |
rune update |
Incremental update of RUNE.md |
rune context <query> |
Get targeted context (stdout) |
rune doctor |
Check repository health |
rune serve |
Start MCP server (optional, stdio) |
AI coding agents automatically discover and read project files like RUNE.md. No special setup needed:
| Agent | How it reads RUNE.md |
|---|---|
| Antigravity | Reads project files automatically |
| Claude Code | Reads project files in workspace |
| Cursor | Reads .md files in project root |
| Codex | Reads project context files |
| Windsurf | Reads project files automatically |
| Copilot | Reads via @workspace context |
For agents that support MCP, you can optionally run rune serve for richer tool-based access.
Edit .rune/spec.md to add a project description:
# My Project
A REST API for managing user accounts.
Backend: Go with Gin
Database: PostgreSQL
Auth: JWT tokens
Edit .rune/conventions.md to add coding rules:
# Conventions
- Use repository pattern for data access
- Never use raw SQL, use sqlc
- All endpoints return JSON
- Tests required for all handlers
Both files are included in the generated RUNE.md.
[!NOTE] Ownership & LLM Updates
- Human-authored: These files are intended to be human-authored guardrails. Rune is local-first and offline; it will never automatically overwrite or modify these files during
rune updateorrune index.- Agent updates: AI coding agents should avoid modifying these files unless you explicitly instruct them to document a new architectural decision or project convention.
Rune extracts imports, exports, and dependencies from:
Go · Python · JavaScript · TypeScript · Rust · Java · Kotlin · Ruby · PHP · C/C++ · C# · Swift · Dart · Lua · Scala · Elixir · Erlang · Zig · Vue · Svelte
| Metric | Target |
|---|---|
| Cold index (10k files) | < 30s |
| Incremental update | < 1s |
| Startup | < 100ms |
| Memory | < 200MB |
RUNE.md fileRUNE.md is plain markdownMIT