Selvedge: Persistent Decision Memory for AI Agents

Overview

Selvedge is a free, open-source tool designed to give AI coding agents a way to remember past decisions. It works as a local server and a command-line interface that lets these agents log, find, and study the reasons behind code changes. By saving this information in a local database, Selvedge helps developers understand why code was changed, not just what was changed. This is especially useful when working with AI agents that might make many changes in a short time.

Benefits

Selvedge offers several key advantages for developers using AI to write code. First, it preserves the full story of a project. Without it, a developer might see the final code but miss the alternatives that were tried or the specific reasons a certain path was chosen. Selvedge captures the "why" behind every change. Second, it works entirely on your local machine. This means no data is sent to the cloud, which keeps your project private and fast. Third, it organizes history by project parts like files or functions rather than just line numbers. This makes it easier to find related changes. Finally, it includes a quality check to ensure that the reasons logged by AI agents are meaningful and not just generic placeholders.

Use Cases

Selvedge is perfect for teams that rely on AI agents to build software. It helps developers debug issues by showing the original constraints and decisions made during implementation. It is also useful for understanding rejected approaches and seeing why they were discarded. For long-term projects where multiple AI sessions contribute to the codebase, Selvedge maintains the necessary context so new sessions can build on past work. It is not meant for creative writing, image generation, or marketing tasks. Instead, it focuses on the technical reasoning behind code evolution.

Pricing

Selvedge is completely free and open source. There are no hidden costs or subscription fees. Users can install it using standard package managers like pip.

Vibes

As a new open-source tool, Selvedge is designed to fill a specific gap in the AI coding landscape. It distinguishes itself from other tools by focusing on local-first architecture and capturing the reasoning behind changes rather than just tracking token costs or generating summaries. Early feedback suggests it is a valuable addition for developers who want more transparency in how AI agents modify their code.

Additional Information

Selvedge uses the Model Context Protocol to connect with AI agents. It stores data in a SQLite file located next to the project code. The system is built to handle multiple users or agents working at the same time safely. It is not a replacement for Git, nor is it a code review tool. It complements existing tools by adding a layer of semantic reasoning to the version control process.