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

"필요 없음 (CPU 기반 초경량 SQLite 및 CLI 작동)",

💾Storage

"패키지 설치 공간 50MB 이내, 이력 DB 크기 수십 MB 수준"

Installation

4-1. Quick Start

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

4-2. 상세 설치

1. PyPI를 통한 Python 패키지 설치

pip install selvedge

2. 대상 프로젝트 디렉터리로 이동 후 자동 설정 마법사 실행

cd your-project selvedge setup

3. 로컬 데이터베이스 초기화 및 git hook 정상 연동 확인

selvedge init

4. 설정 및 연동 상태 진단 검증

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

  1. vv0.3.9.17/12/2026

    Selvedge v0.3.9.1 업데이트에서는 실험 프로토콜이나 데이터의 이름이 변경되더라도 이전의 시도 기록을 정확히 찾아내는 '퍼지 리콜(fuzzy recall)' 기능이 도입되었습니다. 이를 통해 실험 조건이 빈번하게 바뀌는 복잡한 연구 환경에서도 데이터의 연속성과 히스토리를 안정적으로 유지할 수 있습니다. 또한, 에이전트 실행 기록(Agent Trace)을 내보내는 기능이 추가되어 AI 기반의 실험 분석 과정을 더욱 투명하게 검증하고 기록할 수 있게 되었습니다.

🧪 Related Code of Life

No related Code of Life posts yet.