Home

Rune Context Wiki

Git for repository understanding.

Rune is a lightweight, local-first context protocol that helps code LLMs understand large codebases without repeatedly consuming entire source files.

Git stores history.

Rune stores understanding.

---

Why Rune Exists

Modern coding agents spend enormous amounts of tokens repeatedly reading the same files.

Humans don't understand repositories by reading every file from top to bottom. They rely on:

• architecture documents
• conventions
• feature maps
• dependency relationships

Rune gives AI agents the same ability.

---

Philosophy

• Local-first
• Human-readable
• Language-agnostic
• Offline by default
• Simple over clever
• Incremental over full reindexing

---

Core Concepts

.git/

Stores history.

Answers:

What changed?

.rune/

Stores understanding.

Answers:

What does this codebase mean?

---

Repository Structure

.rune/
├── spec.md
├── architecture.md
├── conventions.md
├── graph.json
├── files/
├── features/
├── ownership/
├── sessions/
└── cache/

---

Commands

rune init
rune index
rune update
rune context
rune doctor

---

Roadmap

v0.1

• Core CLI
• Linux support
• macOS support
• Windows support
• Incremental indexing
• Dependency graph

v0.2

• Python plugin
• TypeScript plugin
• Go plugin

v0.3

• Feature maps
• Session memory
• Ownership maps

v1.0

• Stable specification
• Plugin ecosystem
• Broad agent compatibility

---

Documentation

• Getting Started
• Installation
• Commands
• Repository Format
• Architecture
• Plugins
• FAQ

---

Non Goals

Rune is not:

• an IDE
• a cloud service
• a vector database
• an agent framework
• a replacement for Git

Rune provides context.

Agents provide intelligence.