Description
Selvedge is a tool designed to give AI agents persistent decision memory, enabling them to store and retrieve the rationale behind code changes. This capability is crucial for understanding why certain code paths were chosen or rejected, especially in complex projects where decisions may span multiple sessions. Selvedge operates as a local MCP server and CLI, storing project decisions and rejected approaches in a SQLite file located within the project directory.
Read More
The tool is compatible with any AI agent that can connect through local stdio MCP or the CLI, making it versatile for various development environments. It records explicit reasoning for changes, including what changed, when, who made the change, and why. This information is stored locally, ensuring that developers maintain control over their data without relying on a hosted backend.
Selvedge is particularly useful for developers who need to carry decision memory between sessions, preventing the repetition of rejected approaches and providing a clear history of project decisions. It supports full-text search over change history and exports to the Agent Trace format, making it easy to retrieve and analyze past decisions.
The tool is free and open source, emphasizing transparency and accessibility. It is designed to complement existing tools like git, providing a layer of decision memory that traditional version control systems do not offer. By using Selvedge, developers can ensure that the context behind code changes is preserved, facilitating better decision-making in future coding sessions.
- CategoryAI Agent Builders
- Pricing ModelFree
- DeploymentRuns locally
- PlatformsWeb
Selvedge's Core Features
Persistent decision memory
Local SQLite storage
MCP and CLI compatibility
Entity-level attribution
Full-text search over change history
Exports to Agent Trace format
Free and open source
No required hosted backend
How to use Selvedge?
Install: Set up Selvedge in your project directory
Connect: Link your AI agent through MCP or CLI
Record: Save decisions and rejected approaches
Retrieve: Access stored rationale in future sessions
Selvedge's Use Cases
- Code Change Rationale
- Decision Memory
- Rejected Approaches
- Project History
- Local Storage
