Selvedge
by masondelancommunityv0.3.9
8
Selvedge is a local MCP server that lets AI coding agents log structured change events and reasoning into a SQLite database under .selvedge/ next to a codebase. It also provides commands to query that history, including blame, prior attempts, diffs, search, and stale decisions, so users can recover why changes were made.
From the registry: Long-term memory for AI-coded codebases — agents log the why behind every change and read it back.
Install & configure
Prerequisites
- requiredInstall Selvedge Python packageInstall the Selvedge package so the MCP server command is available on your PATH.
https://pypi.org/project/selvedge/$ pip install selvedge - requiredInitialize Selvedge in your projectRun once inside each project to create the local Selvedge database under .selvedge/.
$ selvedge init
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `selvedge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Selvedge Python package** — Install the Selvedge package so the MCP server command is available on your PATH. Run: `pip install selvedge` (https://pypi.org/project/selvedge/)
- **Initialize Selvedge in your project** — Run once inside each project to create the local Selvedge database under .selvedge/. Run: `selvedge init`
Canonical MCP server config (stdio transport):
- command: `selvedge-server`
- args: []
- optional environment variables:
- `SELVEDGE_DB`: Optional path override for the Selvedge SQLite database. If unset, Selvedge uses the project database created by `selvedge init`, or falls back to the global database location. (example: `<path-to-selvedge-db>`)
Note: The README recommends `selvedge setup` as the easiest path because it installs MCP wiring and agent instructions automatically, but the canonical manual MCP server entry is a stdio server using the `selvedge-server` command with no args. Selvedge stores data locally in SQLite.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README recommends `selvedge setup` as the easiest path because it installs MCP wiring and agent instructions automatically, but the canonical manual MCP server entry is a stdio server using the `selvedge-server` command with no args. Selvedge stores data locally in SQLite.
Tools (10)
blame
Shows the recorded reasoning and metadata for a specific entity or change
prior_attempts
Returns previous attempts on an entity, including inferred outcome and rejection reasoning
stale_decisions
Finds decisions whose revisit date has passed and whose entity is still in active use
log_change
Records a structured change event with reasoning and metadata
diff
Shows recent changes for an entity or scope
search
Searches logged events by text or entity-related terms
status
Shows overall log status such as total events
doctor
Checks the local store and warns about path or data issues
migrate-paths
Backfills and canonicalizes stored entity paths
stale
CLI counterpart to stale_decisions for listing stale decisions
Packages
selvedge
pypiv0.3.9transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Jun 22, 2026
- Last commit
- Jun 17, 2026
- Registry name
- io.github.masondelan/selvedge