# MindMemOS

> Give your agent long-term memory across sessions: MindMemOS's CLI to store, search, correct and consolidate what it learns about you.

MindMemOS is an open-source long-term memory layer for AI agents. This skill pack teaches your agent to use the mindmemos command-line tool, so it can store what you tell it, recall it in later sessions, and keep that memory accurate over time. You can use the MindMemOS cloud service or run the server yourself.

What you can do with it
- Store facts, preferences and conversation turns. MindMemOS pulls out what lasts and merges it with what it already knows
- Search memory before answering, with fast vector recall or a multi-step agentic search, optional reranking and a token budget
- List, update or delete specific memories when one is stale, wrong or sensitive
- Send feedback when a recalled memory was wrong or missing, and run a background "dreaming" pass that consolidates memories
- Register, version and roll back skills with the CLI's skill commands
- Follow its guides to wire memory into OpenClaw and DeepSeek Harness, so memories are recalled and written automatically

How it connects
- Install the CLI with pip install mindmemos-sdk (or pipx or uv tool install), then run mindmemos auth with an API key, a user id and the server address.
- Use the cloud service at mindmemos.cn with a key from its website, or self-host the open-source server, which runs on Docker with your own chat and embedding models.
- Scope reads and writes with a stable user id so memories don't mix between people.

Good to know
- The pack also includes a small xlsx skill (openpyxl basics) that the project uses as the starting point for its spreadsheet skill-evolution experiments.
- Guides for Codex and Claude are listed as planned.
- It's open source under the MIT licence.

- Type: Skill
- Made by: mindscale-noah
- Category: Productivity
- Formats: Skills
- Version: latest
- Website: https://mindmemos.cn
- Source: https://github.com/mindscale-noah/MindMemOS
- Page: https://pluginboard.ai/skills/mindmemos

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the MindMemOS folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Gemini

In Gemini: Download the MindMemOS folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### GitHub Copilot

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.copilot/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.copilot/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Cursor

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.cursor/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.cursor/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Claude Code

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.claude/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.claude/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Codex

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.agents/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.agents/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Antigravity

In Antigravity: Copy the MindMemOS folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Gemini CLI

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.gemini/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.gemini/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Replit

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli .agents/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx .agents/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### OpenClaw

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.openclaw/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.openclaw/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### OpenCode

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.config/opencode/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.config/opencode/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

### Hermes Agent

Copy all 2 skills, in your terminal:

```shell
npx -y degit mindscale-noah/MindMemOS/skills/mindmemos-cli ~/.hermes/skills/mindmemos-cli
npx -y degit mindscale-noah/MindMemOS/resources/skill_evolve/spreadsheetbench_init_skill/xlsx ~/.hermes/skills/xlsx
```

View the skills on GitHub: https://github.com/mindscale-noah/MindMemOS

---
From Pluginboard (https://pluginboard.ai).
