Skip to content

rcllr: one memory for all your coding agents

What Claude Code learns, Codex knows too. rcllr (say “recaller”) is a CLI that gives your coding agents one shared long-term memory: Markdown notes in a Git repo you own.

npm install -g rcllr

Version 0.5.5, MIT licensed.

From one agent to the next

  1. Claude Code learns something

    It writes a note to your brain. What Claude Code keeps in its own memory, rcllr imports as well.

  2. A hook commits it

    The brain is a Git repository. With a private remote, the hook pushes the note to your other machines.

  3. Codex finds it

    In its next session, Codex asks the brain before it answers, and gets the note.

    rcllr context "How does the deploy work?"

What else rcllr does

  • Plain Markdown in Git

    No server, no database, no account. Your notes are Markdown files in a Git repository you own and can read without rcllr.

  • On every machine, or on none

    Hooks commit every change. With a private remote they push it too, so your memory follows you. Without one, nothing leaves your machine.

  • Work and private stay apart

    Scopes keep a work answer free of private notes. Sensitive notes stay hidden from agents until you name the topic yourself.

  • Brings what they already remember

    rcllr imports what each agent remembers on its own, so the other one can search it too.

  • Fast enough to ask every time

    A search takes about 0.13 seconds in a brain of 200 notes, so agents can check their memory before every answer.

  • Open to the next agent

    Any agent that can run a shell command can read and write the brain. rcllr ships hooks for Claude Code and Codex.

What you need

  • A terminal on macOS, Linux or Windows (with Git for Windows)
  • Node.js 22.18 or newer and Git
  • A coding agent such as Claude Code or Codex

New to the terminal? The quickstart shows every command to type.

Questions

How do I give Claude Code long-term memory?

Install rcllr, create a brain with rcllr init and run rcllr install inside it. Then tell Claude Code in your global CLAUDE.md to ask the brain with rcllr context before it answers questions about earlier work.

Quickstart

Can Claude Code and Codex share the same memory?

Yes, that is what rcllr is for. Both call the same CLI on the same brain, and the hooks keep it in sync. Codex reads the rules from AGENTS.md, Claude Code from CLAUDE.md, which points to the same file.

Agent setup

How is rcllr different from CLAUDE.md, AGENTS.md or built-in memory?

CLAUDE.md and AGENTS.md hold rules that load into every session. Built-in memory works per project, for one agent, on one machine. rcllr is searchable knowledge across projects, agents and machines. If you work on one project on one machine, the agent's own memory is enough.

Why not built-in memory?

How is it different from memory servers like mem0 or claude-mem?

rcllr runs no server and keeps no database. A note is a Markdown file in your own Git repository, so you can read, edit and review every line of your agents' memory.

Can I keep private notes away from my agent?

Yes. Mark a note or a folder as sensitive and agents never see it, not even in search results, unless you name the topic in your prompt. Scopes keep work and private apart.

Scope and sensitivity

Does my memory leave my computer?

Only if you want it to. A synced brain pushes to the private Git remote you choose. A local brain never talks to any remote.

Local or synced

Can I import the memory my agents already have?

Yes. rcllr import-memory mirrors what your agents remember on their own into your brain, in a scope you choose, and keeps it up to date after each session.

Extras