DevDiff

Appearance

Never Write a Changelog Again — How DevDiff Automates the Most Boring Part of Development ​

July 6, 2026 · Eldrex Delos Reyes Bula

Let's be honest: nobody likes writing changelogs.

After hours of intense debugging, refactoring, and code review, the last thing you want to do is spend another hour digging through messy git history to write release notes. Yet, you do it because stakeholders, product managers, and users need to understand what changed.

We’ve all seen the lazy alternative: copy-pasting git commits directly into release notes. The result? A wall of text filled with "fix typo," "wip," and "update dependencies" that tells your team absolutely nothing about the actual impact.

DevDiff was built to solve this. It is a privacy-first, offline-first changelog generator that automatically translates raw git diffs into structured, high-quality, persona-based explanations. And it does it entirely on your local machine using local AI models.

🧐 What Makes a Good Changelog? ​

A great changelog isn't just a list of modified files or commit titles. It needs to answer three questions for three different audiences:

  1. What changed? (For developers: Which exports, classes, and modules were modified?)
  2. Why does it matter? (For product managers and users: What features were added or bugs resolved?)
  3. Is it safe? (For security and operations teams: Are there breaking changes, security vulnerabilities, or database alterations?)

Writing this manually for every release is exhausting. DevDiff automates the entire flow.

🛠️ Setup in 3 Taps ​

We designed DevDiff to be completely friction-free. You don't need to sign up, configure cloud accounts, or pay subscription fees. You can go from install to your first AI-generated explanation in under a minute.

Tap 1: Install the CLI ​

Install the global command-line tool using your package manager:

bash
npm install -g @eldrex/cli

Tap 2: Initialize Config ​

Run the initialization wizard in your project root to generate a default config file:

bash
devdiff init

This creates a .devdiff.config.js configuration file in your repository with pre-configured settings.

Tap 3: Generate ​

Make some changes, stage them in git, and run:

bash
devdiff generate

🎨 Before and After: Real Example ​

Here is what happens when you modify a core validation schema in your project.

Before: Raw Git Log ​

text
commit a7b3c29d10e83bf
Author: Developer <dev@devdiff.dev>
Date:   Mon Jul 6 12:44:11 2026

    fix schema issues and add metadata fields

After: DevDiff Output ​

markdown
# 📝 DevDiff Changelog - v1.0.7

## 🚀 Key Improvements

- **Security & Compliance Auditing**: Refactored the core validator to reject invalid tokens, enhancing API safety.
- **Dynamic Configuration metadata**: Added a `metadata` object supporting custom tracking fields.

---

## 📦 File-Level Impact

### 🛠️ Modified
- **[packages/core/src/schema.ts](file:///packages/core/src/schema.ts)**
  - Added new `metadata` type definitions.
  - Hardened string bounds checking on user input fields.

---

## ⚠️ Warning Checks
- ℹ️ **Migration Required**: Minor schema updates. No breaking structural migrations detected.

🔒 Why Local AI Matters ​

Most AI developer tools send your code directly to cloud API servers. For many developers, companies, and enterprise repositories, uploading proprietary intellectual property to third-party endpoints is a non-starter.

DevDiff is designed to be offline-first. It queries a locally running instance of Ollama using lightweight models like Llama 3.2 3B or Qwen 2.5 Coder.

  • Zero cost: No API keys, no subscription charges, no token usage fees.
  • 100% private: Your source code never leaves your computer.
  • Offline-capable: Runs perfectly on airplanes, trains, or inside air-gapped secure networks.

If you do want to use cloud providers (like OpenAI, Anthropic, or Google Gemini), DevDiff supports them as an opt-in fallback via the devdiff auth add command. But privacy remains our default.

🚀 Get Started Today ​

Changelog writing shouldn't be a chore. Run npm install -g @eldrex/cli and let DevDiff handle your next release notes automatically.