Give your AI a memory, in about two minutes.
Sibyl Memory is a plugin that lets your AI remember your work between sessions. No account needed to start. No config files to edit. Here is the whole setup, and how to manage it after.
Setup
Three steps, about two minutes. You install it, sign in, and connect it to your AI.
-
Step 1
Install it
Pick either one. Both install everything you need in one go.
Both pull in the full toolkit. If you see an "externally managed environment" error, jump to "If something did not work" at the bottom for the one-time fix.
-
Step 2
Sign in
Run this. It opens a sign-in page in your browser.
sibyl initSign in there with a wallet, or with your email and a code. The terminal picks it up on its own. The free plan gives you the full memory system at no cost, no card needed.
-
Step 3
Connect it to your AI
This finds your AI app and connects Sibyl to it for you. No settings to edit.
sibyl setupThen restart your AI app. That is it, Sibyl is connected.
It connects automatically to Claude Code, Codex, and Hermes. If you use a different app,
sibyl setupwires the ones it recognizes; for anything else, add Sibyl in your app's own memory or connections settings. Either way your AI gains three new abilities: it can save, recall, and search what it remembers. -
Step 4
Test it works
Open your AI and tell it something worth remembering, like: "remember that I like short, direct answers." Close it, open it again later, and ask: "how do I like my answers?" It will know. That is the whole thing, your AI remembers now.
If something did not work
The steps above work for almost everyone. If the install showed an "externally managed environment" error, your system wants a sandbox first. These two lines make one and install Sibyl inside it:
python3 -m venv ~/.sibyl-memory/venv && source ~/.sibyl-memory/venv/bin/activate
pip install sibyl-memory-cli
Then carry on from Step 2 (sibyl init).
Connected nothing in Step 3? Make sure your AI app was open, then run sibyl setup again.
Management
Once Sibyl is installed, here is how to keep it healthy, up to date, and running lean. You will not reach for most of these day to day, they are here when you want them.
Check it is working
See your account, memory size, and plan:
sibyl status
Run a quick self-check of the memory engine:
sibyl health
Keep it up to date
The plugin improves often. See if you are behind, then update in place:
sibyl update
sibyl update --apply
If you connected Claude Code or Codex, also refresh the connector:
pip install -U sibyl-memory-mcp
Manage your devices
See and sign out the devices on your account:
sibyl devices
Best practices: keep your context small.
Sibyl works best when your AI keeps a small, sharp context and lets memory hold the rest. A lean context is faster, cheaper, and more accurate. Two habits keep it that way.
Move your context into memory
If your project keeps notes in files like CLAUDE.md or AGENTS.md, move them into memory once. Sibyl backs up every file first, checks the copies, then hands the transfer to your own AI to read on your machine. Sibyl Labs never sees your files.
sibyl migrate
Run it from the project you want to bring over. Trimming the old files is the last step, it is optional, and only after you confirm.
Save at the end of a session
sibyl-save is a small companion skill that commits a whole session into memory in one step, so your progress carries to the next session and your working context stays clean. Install it once, then run it after a large session or at the end of any session.
git clone https://github.com/Sibyl-Labs/sibyl-save
mkdir -p .claude/skills/sibyl-save && cp sibyl-save/SKILL.md .claude/skills/sibyl-save/
Then run /sibyl-save setup once, and /sibyl-save whenever you want to save. It works with Claude Code, Codex, Cursor, and Hermes.
Let it keep itself lean
On the free plan you keep memory tidy yourself with the two habits above. Paid plans are adding automatic debloat: it prunes and compacts your memory for you, so it stays lean and fast without you thinking about it.
See paid plans →Sibyl Memory is open source.
Read the code, file an issue, or star it on GitHub.