Selvedge

Name: Selvedge
Author: masondelan

@masondelan

About Selvedge

Selvedge is a local, open-source MCP server that captures the *why* behind every change AI coding agents make — live, in the moment, from the agent's own context (not inferred later by a second LLM). It logs the entity (DB column, table, function, route, env var, dependency), the

#mcp-server #ai-tools #claude-code #cursor #developer-tools #code-tracking #change-tracking #audit-log #agent-memory #sqlite #python #observability

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "selvedge": {
      "command": "uvx",
      "args": [
        "--from",
        "selvedge",
        "selvedge-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Selvedge?

Selvedge is a long-term memory system for AI-coded codebases that captures the reasoning behind code changes as they are made by AI agents. It stores why a change was made, not just what changed, using an MCP server that agents call during development.

How to use Selvedge?

Install via pip install selvedge, run selvedge init once, and add configuration lines to your CLAUDE.md. Use commands like selvedge blame <entity> to see the history and reasoning behind any code change.

Key features of Selvedge

Captures agent reasoning live during code changes, not inferred post-hoc
Entity-level attribution for database columns, tables, env vars, APIs, functions
Changeset grouping across multiple entities for complex feature rollouts
SQLite storage with zero external dependencies
Concurrent write support with retry logic and WAL mode
CLI commands: blame, status, diff, search, history, import

Use cases of Selvedge

Debugging schema decisions months after the AI agent session has ended
Understanding why a specific database column or API endpoint was added
Auditing dependency changes across long-running AI-coded projects
Solo developers tracking reasoning across weekend builds and side projects
Pulling up the full scope of a billing migration that touched multiple files

FAQ from Selvedge

How does Selvedge differ from git blame?

Git blame tells you what changed and when. Selvedge captures why the change was made, with reasoning written by the AI agent from the same context that produced the change.

What are the dependencies and runtime requirements?

Selvedge uses SQLite for storage with zero external dependencies. Install via pip.

Where does Selvedge store data?

In a SQLite file under .selvedge/ in your project directory, or globally at ~/.selvedge/selvedge.db.

What transports and authentication does Selvedge use?

Selvedge communicates via MCP protocol over JSON-RPC stdio transport.

How does reasoning capture work?

Reasoning is captured live by the AI agent during the change, written from the same context window that produced the modification. This contrasts with tools that infer reasoning post-hoc from the diff.

Comments

More AI & Agents MCP servers

MCP Claude Code

SDGLBL

MCP implementation of Claude Code capabilities and more

302

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797