DevDiff

Your codebase's memory, not just its history.

---

What is DevDiff?

DevDiff watches your code changes and generates intelligent, human-readable changelogs using AI that you control. It explains what changed and why — not just raw git diffs.

🔒 Privacy-First

Runs 100% locally by default. Your code never leaves your machine.

🤖 Bring Your Own AI

Use Ollama, llama.cpp, Transformers.js, OpenAI, Anthropic, or any provider. Full control.

⚡ Token Optimized

Smart diff batching, AST trimming, and caching reduce AI token usage by up to 85%.

---

Quick Start

# Install globally
npm install -g @eldrex/cli

# Initialize in your git repo
cd my-project
npx devdiff init

# That's it! Every commit gets an AI explanation.
git commit -m "add user auth"
# ✨ DevDiff automatically generates changelog...

With Ollama (free, local, offline)

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Pull a model
ollama pull llama3.2:3b

# DevDiff auto-detects it!
npx devdiff generate

---

How It Works

Your Code Changes
        │
        ▼
┌──────────────────┐
│  Git Diff Parser  │ ← Watches .git for changes
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  AST Trimmer      │ ← Strips non-essential code
│  Secret Scanner   │ ← Redacts sensitive data
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  AI Router        │ ← Picks best provider
│  Batcher          │ ← Optimizes token usage
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  Your AI           │ ← Ollama / OpenAI / etc.
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  Changelog        │ ← Human-readable markdown
│  Generator        │
└──────────────────┘

---

Features

• 📝 AI-Powered Changelogs — What changed and why
• 🔒 Local-First — No data leaves your machine
• 🤖 BYOAI — Your AI, your rules
• ⚡ Token Optimized — Up to 85% less token usage
• 🔌 Integrations — VS Code, Vite, GitHub Actions, Linear, Jira
• 📊 Dashboard — Beautiful web UI and terminal dashboard
• 🌍 MIT Licensed — Free forever

---

Packages

Package	Description	Version
@eldrex/core	Core changelog engine
@eldrex/cli	Command-line interface
@eldrex/vite	Vite plugin
@eldrex/vscode	VS Code extension	Marketplace

---

---

💻 VS Code Extension & Offline Pre-Release

For the VS Code extension, you can install it directly from the marketplace or download the packaged pre-release VSIX file:

• Download VSIX: Get the latest release from GitHub Releases
• For setup instructions, see the VS Code Extension README.

---

📚 Documentation & Help Guides

• 📖 Getting Started: 5-Minute Setup Guide
• 🤖 AI Model Setup: Ollama Setup Guide
• ❌ Troubleshooting: Ollama Errors & Fixes | Windows-Specific Issues | Quick Fixes Matrix
• 🔒 Security & Versioning: Security Model Policy | Immutable Version Strategy
• 📖 Full Documentation Site: devdiff.vercel.app

---

🤝 Support & Consulting

DevDiff is a community-supported open-source project created and maintained by Eldrex Delos Reyes Bula.

If you or your organization finds DevDiff valuable, consider supporting or booking professional consulting services:

• 📧 Consulting & Priority Support: eldrexdelosreyesbula@gmail.com
• ☕ Ko-fi Donations: Sponsor on Ko-fi
• 💳 PayPal Support: Donate via PayPal Me
• 📄 Full Support Channels: See SUPPORT.md

---

👥 Community & Contributing

• 📝 Discussions: GitHub Discussions
• 🐛 Bugs & Features: GitHub Issues
• 🤝 Contributing: See CONTRIBUTING.md and CODE_OF_CONDUCT.md

---

📄 License

MIT © Eldrex Delos Reyes Bula and Contributors