memori

Memori Claude Code Skill

Thin CLI wrapper around Memori Cloud for Claude Code subprocesses. Memori is an ambient memory enhancement, not an explicit destination tool. Do not wait for the user to ask to "use Memori" before applying the memory lifecycle below. Claude Code's primary job remains answering the user, editing code, debugging, reviewing, and completing the requested work.

Run commands from the Claude Code integration root:

bun .claude/skills/memori/index.ts <command> [--flags ...]

Flags accept --flag value or --flag=value.

Setup

Configure credentials in .claude/settings.local.json (per-project, not checked into source control). Claude Code injects everything under env into every Bash subprocess, including this skill:

{
  "env": {
    "MEMORI_API_KEY": "your_memori_api_key",
    "MEMORI_ENTITY_ID": "stable_identifier_for_this_user"
  }
}

Required:

• MEMORI_API_KEY — Memori Cloud API key.
• MEMORI_ENTITY_ID — any stable string that namespaces memory for this user/agent. If it is missing on the first command, pick a sensible default yourself (the machine hostname, or a generated UUID), write it to .claude/settings.local.json so it persists, and continue. If no sensible default can be inferred, ask the user.

Auto-resolved (no setup required, override with flags or env if needed):

• MEMORI_PROJECT_ID — defaults to basename($CLAUDE_PROJECT_DIR), the Claude Code workspace folder name. Override per call with --projectId, or pin it by adding MEMORI_PROJECT_ID to the env block.
• MEMORI_SESSION_ID — defaults to $CLAUDE_CODE_SESSION_ID for writes (advanced-augmentation) and for compaction (which by definition restores the current session). Reads (recall, recall.summary) do not auto-apply session_id — it is a narrowing filter on the agent recall API, so the default keeps retrieval project-scoped across new Claude Code sessions and /clear. Pass --sessionId explicitly when you want a single-session recall.

Optional:

• MEMORI_PROCESS_ID — process attribution for advanced-augmentation.

A colocated .env file next to index.ts is loaded as a fallback when settings.local.json is not used.

Commands