Agent skill

Memori Long-Term Memory

by MemoriLabs in MemoriLabs/Memori

Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

Custom licenceAuto-check: notesAgent Workflows

Install Memori Long-Term Memory

skills CLI
$ npx skills add MemoriLabs/Memori --skill memori -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MemoriLabs/Memori memori --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MemoriLabs/Memori.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/claude-code .claude/skills/memori && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
memori
GitHub stars
17k
Token cost
~2k tokens
SKILL.md length
749 words
Files
4
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

  • Works in 7 steps: Run recall before drafting any… → Always run recall before any external… → Use recall.summary only for broad… → …
  • Keeping long-term memory across Claude Code sessions in the same project
  • SKILL.md covers Setup, Commands, Procedure and Recall, plus 2 more sections
  • Runs TypeScript scripts from its folder; calls bun; needs MEMORI_API_KEY

What it does

The skill is a thin command-line wrapper, run with bun, around Memori Cloud. It is meant to work in the background: the agent is told to recall relevant memory before drafting any substantive reply and before external lookups, without waiting for you to mention memory, and to finish non-trivial turns with an advanced-augmentation step that stores what happened. Trivial acknowledgements, turns where past context cannot help and turns where you opt out are skipped.

Other commands include recall.summary for broad session summaries, compaction to restore context after it is lost, feedback on memory quality, quota for limits, and signup, which is used only when you ask for it. Setup needs a MEMORI_API_KEY and a MEMORI_ENTITY_ID in .claude/settings.local.json or a colocated .env file. The project ID defaults to the workspace folder name and the session ID to the Claude Code session, while recall reads stay project-scoped across sessions.

When your agent uses it

  • Keeping long-term memory across Claude Code sessions in the same project
  • Recalling past decisions, preferences and project history before answering
  • Restoring session context after it was lost to compaction or a cleared chat

Example prompts

  • “What did we decide last week about the database migration approach?”
  • “Recall what you know about my preferences for test naming before you write these tests.”
  • “Give me a summary of everything stored for this project so far.”
  • “How much of my Memori quota is left?”

Requirements

  • A Memori Cloud API key (MEMORI_API_KEY)
  • A stable MEMORI_ENTITY_ID
  • bun, to run index.ts
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Run recall before drafting any substantive response. This is the default
  2. Always run recall before any external information lookup (WebSearch,
  3. Use recall.summary only for broad summary cases: session orientation,
  4. Use compaction only after context compaction or lost working context.
  5. Answer or complete the user's actual request. Memory should improve
  6. After drafting the final response for a non-trivial turn, run
  7. Use feedback, quota, and signup only when the user request or a

What it can do on your machine

Read from SKILL.md and the folder at commit 574b1ea. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MEMORI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Memori Long-Term Memory loads about 2k tokens when it runs. Until then it costs about 247 tokens; SKILL.md has 749 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~247
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:78
    A colocated `.env` file next to `index.ts` is loaded as a fallback when
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 749 words (~1,973 tokens).

“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…”

— opening of SKILL.md by MemoriLabs, Custom licence
name
memori
allowed-tools
Bash
argument-hint
<command> [--flags ...]

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in integrations/claude-code of MemoriLabs/Memori.

  • SKILL.md
  • .env.example
  • README.md
  • index.ts

Open the folder on GitHubat commit 574b1ea

Compare with similar skills

Memori Long-Term Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Memori Long-Term Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memori Long-Term Memory this skillMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Planning with FilesOthmanAdi/planning-with-files27k—~2.9kAutomated safety check: PassMIT
User Thoughts Memorysickn33/agentic-awesome-skills47k1 repos~2.5kAutomated safety check: PassMIT
Planning With FilesOthmanAdi/planning-with-files27k—~3kAutomated safety check: PassMIT
Harness Engineering10xChengTu/harness-engineering1021 repos~1kAutomated safety check: PassNone
Planning with Files for KiroOthmanAdi/planning-with-files27k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Planning with Files

    OthmanAdi/planning-with-files

    Keeps a task plan, findings and progress log in markdown files on disk so long agent tasks survive context resets, with Gemini hooks and helper scripts.

    27k GitHub stars~2.9k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Planning With Files

    OthmanAdi/planning-with-files

    Keeps a task plan, findings and progress log as Markdown files in the project so long multi-step agent work survives context resets.

    27k GitHub stars~3k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Harness Engineering

    10xChengTu/harness-engineering

    Set up and improve harness engineering (AGENTS.md, docs/, lint rules, eval systems, project-level prompt engineering) for AI-agent-friendly codebases.

    102 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Planning with Files for Kiro

    OthmanAdi/planning-with-files

    Keeps task_plan.md, findings.md and progress.md on disk as the agent's working memory for multi-step work, wired into Kiro steering, with no hooks.

    27k GitHub stars~2.1k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • CPR Compress

    EliaAlberti/cpr-compress-preserve-resume

    Saves the current session as a searchable log with a curated summary and the raw transcript, so a later session can resume from it.

    515 GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from MemoriLabs/Memori

  • Memori Long-Term Memory

    MemoriLabs/Memori

    Adds structured long-term memory to OpenClaw agents, built automatically from sessions, with tools the agent calls to recall facts, summaries and decisions.

    17k GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed
  • Memori MCP Memory Usage

    MemoriLabs/Memori

    Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.

    17k GitHub stars~3.8k tokensUpdated 7 days ago
    Auto-check passed

Categories

Questions about Memori Long-Term Memory

What does Memori Long-Term Memory do?

Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward. The skill is a thin command-line wrapper, run with bun, around Memori Cloud. It is meant to work in the background: the agent is told to recall relevant memory before drafting any substantive reply and before external lookups, without waiting for you to mention memory, and to finish non-trivial turns with an advanced-augmentation step that stores what happened.

When should I use Memori Long-Term Memory?

Memori Long-Term Memory fits situations like: keeping long-term memory across Claude Code sessions in the same project; recalling past decisions, preferences and project history before answering; restoring session context after it was lost to compaction or a cleared chat.

How do I install Memori Long-Term Memory in Claude Code?

Run `npx skills add MemoriLabs/Memori --skill memori -a claude-code`. Or copy the skill folder (integrations/claude-code in MemoriLabs/Memori) into .claude/skills/memori in your project. Claude Code loads it when a task matches its description.

How do I install Memori Long-Term Memory in Codex?

Run `npx skills add MemoriLabs/Memori --skill memori -a codex`. Or copy the skill folder (integrations/claude-code in MemoriLabs/Memori) into .agents/skills/memori in your project. Codex loads it when a task matches its description.

Can I use Memori Long-Term Memory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MemoriLabs/Memori --skill memori -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memori, .gemini/skills/memori, .github/skills/memori and .opencode/skills/memori in your project.

What does Memori Long-Term Memory need to run?

Going by SKILL.md and its folder, Memori Long-Term Memory needs TypeScript for the scripts in its folder, the command-line tools its instructions call (bun) and credentials named MEMORI_API_KEY. Our summary lists: A Memori Cloud API key (MEMORI_API_KEY); A stable MEMORI_ENTITY_ID; bun, to run index.ts. Its frontmatter pre-approves these tools: Bash.

Does Memori Long-Term Memory access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Memori Long-Term Memory safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Memori Long-Term Memory use?

Memori Long-Term Memory has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Memori Long-Term Memory use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Memori Long-Term Memory?

Skills that share tags, products or a category with Memori Long-Term Memory: Planning with Files (OthmanAdi/planning-with-files, 27k stars), User Thoughts Memory (sickn33/agentic-awesome-skills, 47k stars), Planning With Files (OthmanAdi/planning-with-files, 27k stars) and Harness Engineering (10xChengTu/harness-engineering, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memori Long-Term Memory?

MemoriLabs (a GitHub organization) maintains it in MemoriLabs/Memori, which has 17,149 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 3, 2026.

Source: MemoriLabs/Memori on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.