Sibyl Memory Get started

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.

  1. Step 1

    Install it

    Pick either one. Both install everything you need in one go.

    Option A, with pip
    pip install sibyl-memory-cli
    Option B, one-line installer
    curl -fsSL https://sibyllabs.org/install | sh

    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.

  2. Step 2

    Sign in

    Run this. It opens a sign-in page in your browser.

    sibyl init

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

  3. Step 3

    Connect it to your AI

    This finds your AI app and connects Sibyl to it for you. No settings to edit.

    sibyl setup

    Then 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 setup wires 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.

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

Everyday commands

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

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.

Claude Code
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.

sibyl-save on GitHub →
On paid plans

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 →
Open source

Sibyl Memory is open source.

Read the code, file an issue, or star it on GitHub.