skillmem
Local skill memory for Claude Code and Codex: useful skills grow, stale ones fade
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.13.0
- Listing updated
- 2 days ago
About skillmem
skillmem is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Where most memory tools store facts, skillmem stores procedures: a trigger, the steps taken, the outcome and lessons learned. Everything sits in a plain SQLite file on your disk, and reads and writes make no LLM calls, so there is no API key and no per-use cost.
Skills are ranked by how often they actually helped. Strength rises only on evidence from outside the agent's own judgement, such as a passing test, and drops after a failure. Skills left unused fade on an Ebbinghaus-style schedule, and dead ones are moved to a backed-up archive rather than deleted.
Every memory records its origin (owner, agent, imported or derived), and only the owner can approve one as a rule. Unapproved memories are injected inside a marked block that says they are data, not instructions. Each change is also appended to a SHA-256 hash chain that skillmem verify can check for tampering.
Install
Run in a terminal
claude mcp add skillmem -- uvx skillmemAdd to claude_desktop_config.json
{
"mcpServers": {
"skillmem": {
"command": "uvx",
"args": [
"skillmem"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"skillmem": {
"command": "uvx",
"args": [
"skillmem"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"skillmem": {
"type": "stdio",
"command": "uvx",
"args": [
"skillmem"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"skillmem": {
"command": "uvx",
"args": [
"skillmem"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"skillmem": {
"command": "uvx",
"args": [
"skillmem"
]
}
}
}Configuration
SKILLMEM_DBPath to the SQLite database file (default: the platform data directory)
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- mem_learn
- Lets an agent record a skill or note into memory; an agent-written rule stays unapproved until the owner trusts it.
What it does
- Zero-cost reads and writes
- Storing and recalling skills uses no LLM calls, cloud service or API key.
- Bilingual hybrid search
- Full-text search with stemming for English and Russian, plus an optional local embedding layer for cross-language recall.
- Earned skill strength
- Strength grows on external evidence, falls after failures and decays when a skill goes unused.
- Provenance and owner trust
- Each memory records its source, and only the owner can approve a memory as a rule.
- Tamper-evident history
- Edits are chained with SHA-256 so after-the-fact changes can be detected.
- Shared across agents
- Claude Code and Codex use one database, and each record notes which agent wrote it.
- Markdown export
- `export-all` dumps memory to markdown files with YAML frontmatter that re-import to the same records.
Good for
- Let a coding agent reuse how it solved a task last time
- Share learned procedures between Claude Code and Codex
- Keep an auditable record of what an agent learned and when
- Stop imported or agent-written rules from acting as trusted instructions
- Back up and move an agent's skills as plain markdown
Pricing
Open source
Free and Apache-2.0; a cloud sync option is on a waitlist, details not published
Prices change. Check skillmem.dev before you buy.
skillmem FAQ
Does it need an API key or cloud account?
No. It runs locally on SQLite and makes no LLM calls to store or retrieve skills.
How do I install it?
Run pip install 'skillmem[semantic]', then skillmem init --claude-code --codex. The semantic extra is what enables cross-language recall.
What licence is it under?
Apache-2.0, with the engine published on PyPI.
Can skills sync across machines?
Not yet. A skillmem cloud for syncing and team sharing has a waitlist; the local engine does not sync.
Which operating systems are supported?
The README lists macOS, Windows and Linux, with scheduled upkeep via launchd, schtasks and systemd timers or cron.
Is skillmem free?
Yes. skillmem is open source, so you can use and self-host it for free.
How do I add skillmem to Claude Code?
Run this command in your terminal: claude mcp add skillmem -- uvx skillmem
What are the best alternatives to skillmem?
The closest alternatives to skillmem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to skillmem

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools