โ† AI Tools
CodingBeginner

Selvedge

Developed by masondelan and released on July 10, 2026, Selvedge is an open-source, local decision-tracking tool that records the underlying reasoning process and evidence when an AI coding agent modifies code. This tool operates similarly to a digital black box flight recorder, intervening in real-time at the moment the agent changes the source code to capture the AI's thought process and preserve it in the local environment. Unlike traditional version control systems that only record the final modified state of the source code, Selvedge records why the AI modified a specific function and which libraries it used.

Selvedge, released on July 10, 2026, by developer masondelan, is an open-source, local decision-tracking tool that records the underlying reasoning and evidence when an AI coding agent modifies code. This tool functions similarly to a digital black box flight recorder, intervening in real-time when the agent changes source code to capture the AI's thought process and preserve it in a local environment. Unlike traditional version control systems that only record the final modified state of the source code, Selvedge records the logical reasons and causal relationships behind why the AI modified a specific function or added a library, helping developers clearly track this information later.

Existing collaboration and version control tools, such as git blame, only record the physical change history and author of the code, failing to explain the actual reasons or deeper intentions behind the code changes. In particular, when pair programming with an AI agent, a common problem is the expiration of the context window, which leads to the chronic limitation of losing the agent's long-term memory of why it designed the implementation in a certain way. To bridge this gap, Selvedge provides a local repository for recording the thoughts of the AI agent, offering a powerful solution that not only preserves the framework of the code written by the agent but also the decision-making process behind it.

This tool collects metadata about the entire coding activity, as if the AI agent were generating text, and stores it discreetly and quickly in a lightweight SQLite database file in a local directory within the project. It is a completely offline structure that does not transmit any personal information or source code to external servers, ensuring strong data security and confidentiality. Developers can easily integrate it with various intelligent agents that support the command-line interface (CLI) and Model Context Protocol, allowing them to clearly visualize and maintain the entire lifecycle of research source code that requires complex design rationale, such as genomic data processing pipelines or automated protein structure prediction scripts.

๐Ÿ’ป System Requirements

๐Ÿง RAM

"Not required (CPU-based ultra-lightweight SQLite and CLI operation)"

๐Ÿ’พStorage

"Package installation space within 50MB, history database size at the level of tens of MB"

โšก Installation

4-1. Quick Start

pip install selvedge && cd your-project && selvedge setup

4-2. Detailed installation

1. Installing Python packages via PyPI

pip install selvedge

2. Navigate to the target project directory and run the auto-setup wizard.

cd your-project selvedge setup

3. Verify local database initialization and normal operation of Git hooks integration

selvedge init

4. Configuration and Integration Status Diagnostic Verification

selvedge doctor

FAQ

What is Selvedge?

Selvedge, released on July 10, 2026, by developer masondelan, is an open-source, local decision-tracking tool that records the underlying reasoning and evidence when an AI coding agent modifies code. This tool functions similarly to a digital black box flight recorder, intervening in real-time when the agent changes source code to capture the AI's thought process and preserve it in a local environment. Unlike traditional version control systems that only record the final modified state of the source code, Selvedge records the logical reasons and causal relationships behind why the AI modified a specific function or added a library, helping developers clearly track this information later. Existing collaboration and version control tools, such as git blame, only record the physical change history and author of the code, failing to explain the actual reasons or deeper intentions behind the code changes. In particular, when pair programming with an AI agent, a common problem is the expiration of the context window, which leads to the chronic limitation of losing the agent's long-term memory of why it designed the implementation in a certain way. To bridge this gap, Selvedge provides a local repository for recording the thoughts of the AI agent, offering a powerful solution that not only preserves the framework of the code written by the agent but also the decision-making process behind it. This tool collects metadata about the entire coding activity, as if the AI agent were generating text, and stores it discreetly and quickly in a lightweight SQLite database file in a local directory within the project. It is a completely offline structure that does not transmit any personal information or source code to external servers, ensuring strong data security and confidentiality. Developers can easily integrate it with various intelligent agents that support the command-line interface (CLI) and Model Context Protocol, allowing them to clearly visualize and maintain the entire lifecycle of research source code that requires complex design rationale, such as genomic data processing pipelines or automated protein structure prediction scripts.

When should I use Selvedge?

Developed by masondelan and released on July 10, 2026, Selvedge is an open-source, local decision-tracking tool that records the underlying reasoning process and evidence when an AI coding agent modifies code. This tool operates similarly to a digital black box flight recorder, intervening in real-time at the moment the agent changes the source code to capture the AI's thought process and preserve it in the local environment. Unlike traditional version control systems that only record the final modified state of the source code, Selvedge records why the AI modified a specific function and which libraries it used.

๐Ÿ“„ Official Docs๐Ÿ™ GitHub

๐Ÿ“ Update Notes

No update notes yet.

๐Ÿงช Related Code of Life

No related Code of Life posts yet.

BioPlayground

Reading, linking, and lawful quotation stay open; high-speed bulk collection and unauthorized redistribution do not.

Unless stated otherwise, content rights belong to BioPlayground or the relevant rights holder.