Memcrate memcrate

Early days. Memcrate ships Claude Code integration today. Cursor, Cowork, Aider, and an MCP server are on the roadmap — see the repo for status.

Claude Code

Claude Code is the only tool with a Memcrate integration today. Cursor, Cowork, Aider, and MCP are on the roadmap.

Install

From any directory:

memcrate install claude-code

This unpacks three skill files into ~/.claude/skills/:

~/.claude/skills/
├── save/SKILL.md
├── load/SKILL.md
└── pin/SKILL.md

On Windows the path is %USERPROFILE%\.claude\skills\.

Claude Code picks them up on the next prompt — no restart, no permission setup.

Use

In any Claude Code session, the three verbs are slash commands:

/load
/save
/pin

Each one runs the matching skill. The skills handle:

  • Finding your vault (default ~/vault; falls back to a $HOME scan)
  • Reading the canonical context files
  • Writing session logs and context updates in the right format

What each skill does

/load

Reads Core/Context/Profile.md, Core/Context/Projects.md, Core/Context/Current State.md, and the three most recent session logs. Gives you a short oriented summary. Accepts an optional argument to scope by topic or number of sessions.

/save

Reviews the current session and writes a structured log to Core/Sessions/YYYY-MM-DD-slug.md with frontmatter and the standard sections.

/pin

Promotes a fact, decision, or preference from the current session into one of the canonical context files. Figures out which file (Profile / Projects / Current State) and updates it in place.

Vault discovery

The skills probe in this order:

  1. Read ~/vault/Core/Context/Profile.md
  2. Read the current working directory’s Core/Context/Profile.md
  3. Glob $HOME/*/Core/Context/Profile.md (catches custom locations like ~/myvault)

So if you ran memcrate init ~/myvault, the skills will still find it without configuration.

Upgrading

Each Memcrate CLI release ships the latest skill files. To upgrade:

memcrate install claude-code

This overwrites the skill files in place with the current versions.

Other tools

The roadmap (in priority order):

  • Cursor — .cursorrules template that maps natural-language patterns to the verbs
  • Cowork — packaged skill .zip for Cowork’s UI install flow
  • Aider — .aider.conf.yml rewriter that adds the canonical context files
  • MCP — mcp-memcrate server exposing vault_save, vault_pin, vault_load, vault_search

Until those ship, the vault format works with any tool that can read files — point your tool at the four canonical files and you get most of the value.