Agent skill

Ourmem

by ourmem in ourmem/omem

Shared memory that never forgets. An agent skill from ourmem/omem.

Custom licenceAuto-check passedAgent Workflows

Install Ourmem

skills CLI
$ npx skills add ourmem/omem --skill ourmem -a claude-code

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

GitHub CLI
$ gh skill install ourmem/omem ourmem --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/ourmem/omem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ourmem .claude/skills/ourmem && 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
ourmem
GitHub stars
174
Used in
1 other repo
Token cost
~3.4k tokens
SKILL.md length
1,440 words
Files
5 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

Shared memory that never forgets. An agent skill from ourmem/omem.

  • Works in 5 steps: Fast path (<50ms): stores raw content… → LLM extraction (async): extracts atomic… → Noise filter: regex + vector prototypes… → …
  • Trigger when they want persistent memory
  • SKILL.md covers Key Concepts, When to Use This Skill, What to Remember and Terminology, plus 10 more sections
  • Runs Shell scripts from its folder; calls curl and npx; reaches api.ourmem.ai; needs API_KEY and OMEM_API_KEY

What it does

Ourmem is an agent skill from ourmem/omem. Shared memory that never forgets. Cloud hosted or self-deployed. Collective intelligence for AI agents with Space-based sharing across agents and teams. Use when users say: - "install ourmem" / "install omem" - "setup memory" / "setup omem" - "add memory plugin" - "ourmem onboarding" / "omem onboarding" - "memory not working" - "remember this" - "save this for later" - "don't forget" - "recall preferences" - "what did I say last time" - "import memories" - "share memories" - "share with user" - "share memories to…

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/api-quick-ref.md`, `references/hosted-setup.md` and `references/selfhost-setup.md`).

It sits in Agent Workflows, covering Agent memory and Session handoff. It works with Model Context Protocol and Rust. The repository describes itself as: Shared Memory That Never Forgets — persistent memory for AI agents with Space-based sharing across agents and teams. Plugins for OpenCode, Claude Code, OpenClaw, MCP Server.

When your agent uses it

  • Trigger when they want persistent memory
  • Memory sharing between agents
  • Memory analytics
  • Memory import/export

Example prompts

  • “install ourmem”
  • “install omem”
  • “setup memory”
  • “/ourmem”

Requirements

  • Node.js
  • A Bash shell
  • A credential in OMEM_API_KEY
  • A credential in API_KEY

Workflow steps

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

  1. Fast path (<50ms): stores raw content immediately so it's searchable right away
  2. LLM extraction (async): extracts atomic facts, classified into 6 categories (profile, preferences, entities, events, cases, patterns)
  3. Noise filter: regex + vector prototypes + feedback learning removes low-value content
  4. Admission control: 5-dimension scoring (utility, confidence, novelty, recency, type prior) gates storage
  5. 7-decision reconciliation: CREATE, MERGE, SKIP, SUPERSEDE, SUPPORT, CONTEXTUALIZE, or CONTRADICT

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • npx

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.ourmem.ai

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

  • Credentials

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

    • API_KEY
    • OMEM_API_KEY

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

Context cost

Ourmem loads about 3.4k tokens when it runs, and up to ~9.2k if it reads all its reference files. Until then it costs about 223 tokens; SKILL.md has 1,440 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~223
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder 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 1,440 words (~3,448 tokens).

“ourmem gives AI agents shared persistent memory across sessions, devices, agents, and teams. One API key reconnects everything. Available as hosted (api.ourmem.ai) or self-deployed.”

— opening of SKILL.md by ourmem, Custom licence
name
ourmem
version
1.1.0
keywords
ourmem, omem, memory, persistent memory, agent memory, remember, recall, space sharing, team memory, collective intelligence, memory analytics, memory decay…

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, references) in skills/ourmem of ourmem/omem.

  • SKILL.md
  • references/api-quick-ref.md
  • references/hosted-setup.md
  • references/selfhost-setup.md
  • scripts/verify.sh

Open the folder on GitHubat commit 40f65aa

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ourmem/omem, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ourmem 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.

Ourmem compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ourmem this skillourmem/omem1741 repos~3.4kAutomated safety check: PassCustom licence
Memori MCP Memory UsageMemoriLabs/Memori17k—~3.8kAutomated safety check: PassMIT
Claude Code Auto-Capture HookNateBJones-Projects/OB14.7k—~1.3kAutomated safety check: NotesCustom licence
Memory Searchthedotmack/claude-mem99k—~1.4kAutomated safety check: PassApache-2.0
Engram MemoryPatdolitse/piia-engram163—~1.3kAutomated safety check: PassAGPL-3.0-or-later
Compartment Session SweepMaxFreedomPollard/Compartment578—~750Automated safety check: PassApache-2.0

Similar skills

  • 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 6 days ago
    Agent WorkflowsAuto-check passed
  • Claude Code Auto-Capture Hook

    NateBJones-Projects/OB1

    Fires a Stop hook that captures a Claude Code session transcript automatically when the session ends without a verbal wrap-up.

    4.7k GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Memory Search

    thedotmack/claude-mem

    Searches the claude-mem database of past sessions in layers (index, timeline, full details) to find how a problem was solved before.

    99k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Engram Memory

    Patdolitse/piia-engram

    Routes continuity and recall requests to Engram, a local-first MCP memory and identity layer that saves user-approved lessons, decisions and playbooks.

    163 GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Compartment Session Sweep

    MaxFreedomPollard/Compartment

    Sweeps a conversation before compaction and saves durable facts, decisions and session records into the Compartment encrypted memory vault as short one-claim memories.

    578 GitHub stars~750 tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • TMA1 Peer Sessions

    tma1-ai/tma1

    Lists recent sessions on the current project from other agents such as Claude Code, OpenClaw and Copilot CLI, or from your own earlier work.

    119 GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from ourmem/omem

  • Memory Store

    ourmem/omem

    Store a memory in ourmem. An agent skill from ourmem/omem.

    174 GitHub stars~186 tokensUpdated 4 mo ago
    Auto-check passed
  • Memory Recall

    ourmem/omem

    Search and recall memories from ourmem. An agent skill from ourmem/omem.

    174 GitHub stars~177 tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Ourmem

What does Ourmem do?

Shared memory that never forgets. An agent skill from ourmem/omem. Ourmem is an agent skill from ourmem/omem. Shared memory that never forgets.

When should I use Ourmem?

Ourmem fits situations like: trigger when they want persistent memory; memory sharing between agents; memory analytics; memory import/export.

How do I install Ourmem in Claude Code?

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

How do I install Ourmem in Codex?

Run `npx skills add ourmem/omem --skill ourmem -a codex`. Or copy the skill folder (skills/ourmem in ourmem/omem) into .agents/skills/ourmem in your project. Codex loads it when a task matches its description.

Can I use Ourmem 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 ourmem/omem --skill ourmem -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ourmem, .gemini/skills/ourmem, .github/skills/ourmem and .opencode/skills/ourmem in your project.

What does Ourmem need to run?

Going by SKILL.md and its folder, Ourmem needs a shell for the scripts in its folder, the command-line tools its instructions call (curl and npx) and credentials named API_KEY and OMEM_API_KEY. Our summary lists: Node.js; A Bash shell; A credential in OMEM_API_KEY; A credential in API_KEY.

Does Ourmem access the network?

SKILL.md names 1 domain. In commands or code: api.ourmem.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Ourmem safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ourmem use?

Ourmem 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 Ourmem use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Ourmem?

Skills that share tags, products or a category with Ourmem: Memori MCP Memory Usage (MemoriLabs/Memori, 17k stars), Claude Code Auto-Capture Hook (NateBJones-Projects/OB1, 4.7k stars), Memory Search (thedotmack/claude-mem, 99k stars) and Engram Memory (Patdolitse/piia-engram, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ourmem?

ourmem (a GitHub organization) maintains it in ourmem/omem, which has 174 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on May 24, 2026.

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