<picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/osaxyz/sepiace/main/brand/logo-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/osaxyz/sepiace/main/brand/logo.svg"> <img src="brand/logo.svg" width="128" alt="sepiace"> </picture>

sepiace

Long-term memory for coding agents. Your agent passes one natural-language sentence, and sepiace remembers, recalls, or forgets.<br> _{コーディングエージェントのための長期記憶です。エージェントが自然文を1つ渡すだけで、sepiace が覚える、思い出す、忘れるを行います。}

<p align="center"><a href="#en">Read more in English</a> · <a href="#ja">日本語で読む</a></p>

<a id="en"></a>

English

<p align="center"> <a href="https://github.com/osaxyz/sepiace"><img src="https://img.shields.io/github/stars/osaxyz/sepiace?style=social" alt="Star sepiace on GitHub"></a><br> _{If sepiace helps you, a star keeps us going.} </p>

[!IMPORTANT] sepiace is in beta. Memories are stored on the sepiace server at hi.sepiace.io, separately for each account. Do not ask your agent to remember passwords, API keys, or other secrets.

Quick start

npm create sepiace

It finds Claude Code, Codex, Cursor, VS Code, and OpenCode on your machine, connects the ones you choose, and walks you through signing in. Then start a new session and ask your agent:

• "Remember that I prefer pnpm over npm."
• "What did we decide about the release schedule?"
• "Forget my old home address."

To bring over what your agent already remembers, run /sepiace:migrate in Claude Code, or ask other clients to use the sepiace-migrate skill. It shows you what it found and sends nothing until you agree.

<details> <summary>Install by hand</summary> <br>

Claude Code:

/plugin marketplace add osaxyz/sepiace
/plugin install sepiace@sepiace

Codex:

codex plugin marketplace add osaxyz/sepiace
codex plugin add sepiace@sepiace
codex mcp login sepiace

Other MCP clients: add https://hi.sepiace.io/api/v1/mcp as a remote MCP server (Streamable HTTP). The client signs in through OAuth in the browser.

</details>

Technology

<details> <summary>One sentence in, memory text out</summary> <br>

Your agent writes what it wants in plain words. A judgment network on the server decides whether to save, recall, search, or forget, and combines them when needed. The response contains only memory text, with no IDs, dates, or scores, so the agent spends no tokens building structured arguments.

</details> <details> <summary>Memories are your own words</summary> <br>

Each memory is cut from the sentences in the request. No LLM writes or rewrites it, and when something becomes outdated, only that sentence is replaced. A memory stays in the language you wrote it in.

</details> <details> <summary>Memories fade unless they are used</summary> <br>

Each memory's score follows the FSRS forgetting curve and is computed when it is read. Memories that go unused fade, and once a memory's recall probability drops below 50%, it no longer appears in search. Each recall makes it stick.

</details> <details> <summary>Your memories stay yours, and you can see every request</summary> <br>

Memories are kept separately for each account, and every database query and vector search is scoped to the signed-in user. The console at hi.sepiace.io lists every request with the memories it changed, and a client you disconnect there stops working right away.

</details> <details> <summary>Measured with KiokuBench</summary> <br>

KiokuBench checks what a memory system actually stored: whether it kept the facts, replaced outdated ones, forgot what it was asked to forget, and stayed tidy. See the results on www.sepiace.io.

</details>

Specification

<details> <summary>Plugin components</summary> <br>

| Component | What it does | | --- | --- | | MCP server | Connects https://hi.sepiace.io/api/v1/mcp. It has one tool, memory, which takes one sentence | | memory skill | Tells the agent to recall before acting, to save durable facts as plain sentences about you, and never to send secrets | | Session-start note | A short reminder, about 130 tokens, added when a session starts, is cleared, or is compacted | | migrate skill | Moves local memories into sepiace. It runs only when you ask for it | | update skill | Updates the plugin and the skills in every client to the latest version. It runs only when you ask for it |

</details> <details> <summary>What the migrate skill reads</summary> <br>

| Source | Files | | --- | --- | | Claude Code auto memory | ~/.claude/projects/*/memory/*.md | | Claude Code user instructions | ~/.claude/CLAUDE.md | | Codex memories | ~/.codex/memories/ | | Codex user instructions | ~/.codex/AGENTS.md |

It never changes the local files.

</details> <details> <summary>What npm create sepiace changes</summary> <br>

| Client | What it does | | --- | --- | | Claude Code, Codex | Installs the plugin from this repository | | Cursor | Adds sepiace to ~/.cursor/mcp.json and the skills to ~/.cursor/skills | | VS Code | Adds sepiace to the user mcp.json and the skills to ~/.copilot/skills | | OpenCode | Adds sepiace to ~/.config/opencode/opencode.json and the skills to ~/.config/opencode/skills | | Claude Desktop and claude.ai | Shows how to add sepiace as a custom connector |

The CLI lives in cli/ and is published to npm as create-sepiace.

</details>

<a id="ja"></a>

日本語

<p align="center"> <a href="https://github.com/osaxyz/sepiace"><img src="https://img.shields.io/github/stars/osaxyz/sepiace?style=social" alt="Star sepiace on GitHub"></a><br> _{sepiace が役に立ったら、スターを付けてもらえると励みになります。} </p>

[!IMPORTANT] sepiace はベータ版です。記憶は hi.sepiace.io の sepiace のサーバーに、アカウントごとに分けて保存します。パスワード、API キー、そのほかの秘密は覚えさせないでください。

クイックスタート

npm create sepiace

手元の Claude Code、Codex、Cursor、VS Code、OpenCode を見つけ、選んだものにつなぎ、ログインまで案内します。そのあと新しいセッションで、エージェントに次のように頼んでみてください。

• 「npm より pnpm を使いたい、と覚えて」
• 「リリースの日程はどう決めたっけ？」
• 「前の住所は忘れて」

エージェントがすでに覚えていることを移すには、Claude Code では /sepiace:migrate を、ほかのクライアントでは sepiace-migrate スキルを使うよう頼んでください。見つけたものを見せ、あなたが了承するまで何も送りません。

<details> <summary>手で入れる</summary> <br>

Claude Code

/plugin marketplace add osaxyz/sepiace
/plugin install sepiace@sepiace

Codex

codex plugin marketplace add osaxyz/sepiace
codex plugin add sepiace@sepiace
codex mcp login sepiace

ほかの MCP クライアントでは、https://hi.sepiace.io/api/v1/mcp をリモートの MCP サーバー（Streamable HTTP）として足します。ログインはブラウザの OAuth で行います。

</details>

テクノロジー

<details> <summary>文を1つ渡すと、記憶の本文が返ります</summary> <br>

エージェントは、やりたいことをふだんの言葉で書きます。保存、読み出し、検索、忘れることのどれを行うかはサーバーの判定ネットワークが決め、必要なら組み合わせます。応答は記憶の本文だけで、ID、日時、スコアを含まないので、エージェントは構造化した引数を組み立てるためにトークンを使いません。

</details> <details> <summary>記憶はあなたの言葉のままです</summary> <br>

記憶の本文は、依頼の文から切り出したものです。LLM が本文を書いたり書き換えたりすることはなく、古くなったときは、その文だけを置き換えます。記憶は、書いたときの言語のまま残ります。

</details> <details> <summary>使われない記憶は薄れます</summary> <br>

記憶のスコアは FSRS の忘却曲線に沿い、読み出すときに計算します。使われない記憶は少しずつ薄れ、思い出せる見込みが50%を下回ると検索に出なくなります。読み出されるたびに定着します。

</details> <details> <summary>記憶はあなただけのもので、すべての依頼を確かめられます</summary> <br>

記憶はアカウントごとに分けて保存し、データベースの問い合わせとベクトル検索は、どれもログインした人の分だけを対象にします。hi.sepiace.io のコンソールで、すべての依頼とそれで変わった記憶を確かめられ、そこで取り消したクライアントは、すぐに使えなくなります。

</details> <details> <summary>KiokuBench で測っています</summary> <br>

KiokuBench は、記憶のシステムが実際に何を残したかを確かめます。事実を覚えているか、古くなった事実を置き換えたか、忘れてと頼まれたものを忘れたか、散らかっていないかを見ます。結果は www.sepiace.io で見られます。

</details>

仕様

<details> <summary>プラグインの中身</summary> <br>

| 部品 | 役割 | | --- | --- | | MCP サーバー | https://hi.sepiace.io/api/v1/mcp をつなぎます。ツールは、文を1つ受け取る memory だけです | | memory スキル | 動く前に思い出すこと、長く使う事実をあなたについての文で覚えること、秘密を送らないことを伝えます | | セッションの始めの案内 | セッションの開始、/clear、圧縮のあとに、約130トークンの短い案内を足します | | migrate スキル | 手元の記憶を sepiace に移します。あなたが頼んだときだけ動きます | | update スキル | すべてのクライアントのプラグインとスキルを最新にします。あなたが頼んだときだけ動きます |

</details> <details> <summary>migrate スキルが読むもの</summary> <br>

| 移す元 | ファイル | | --- | --- | | Claude Code の auto memory | ~/.claude/projects/*/memory/*.md | | Claude Code のユーザーの指示 | ~/.claude/CLAUDE.md | | Codex の記憶 | ~/.codex/memories/ | | Codex のユーザーの指示 | ~/.codex/AGENTS.md |

手元のファイルは変えません。

</details> <details> <summary>npm create sepiace が変えるもの</summary> <br>

| クライアント | すること | | --- | --- | | Claude Code、Codex | このリポジトリのプラグインを入れます | | Cursor | ~/.cursor/mcp.json に sepiace を足し、~/.cursor/skills にスキルを置きます | | VS Code | ユーザーの mcp.json に sepiace を足し、~/.copilot/skills にスキルを置きます | | OpenCode | ~/.config/opencode/opencode.json に sepiace を足し、~/.config/opencode/skills にスキルを置きます | | Claude Desktop と claude.ai | カスタムコネクタとして足す手順を表示します |

CLI は cli/ にあり、npm に create-sepiace として公開しています。

</details>