auto-memory CLI
The session-recall command reads an agent’s local sessions and returns past conversations in compact form, with no MCP or hooks.
- 362 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Reads local session stores in read-only mode; a Codex schema repair is applied only after human approval.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/auto-memoryDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reads local session stores in read-only mode; a Codex schema repair is applied only after human approval.
This is third-party code. Review the repository files before installing.
What it does
auto-memory gives an agent memory of past sessions. The `session-recall` CLI reads the local SQLite store of GitHub Copilot CLI, while `session-recall-cc` parses Claude Code JSONL sessions and builds an FTS5 index. `session-recall-codex` covers Codex. The agent calls, for example, `session-recall list --json --limit 10` and gets a table: date, session ID, summary, branch, turn count and project folder. The stated cost of such a query is about 50 tokens. Access is read-only and the schema is checked before each run. If the Codex schema changes, `session-recall-codex-fix` prepares a repair and applies it only after human approval.
Who it is for. Developers who lose context between Claude Code, Codex or Copilot CLI sessions and want the agent to recall earlier work itself.
Good fit when
- An agent has to recall what was worked on last week in this repository.
- A new session needs the last ten sessions with branches and projects.
- Past Claude Code conversations should be searched through an index instead of by scrolling files.
- After a Codex update session reading broke and a reviewed repair path is needed.
Not a fit when
- Shared knowledge memory beyond session history is wanted.
- The agent session store lives on another machine.
- An MCP server is required, and this tool has none.
Example request
Show my last ten sessions as a table: date, branch, project and summary.Limitations
Version 0.6.0 is a GitHub-only release, so a plain PyPI install may return an older one. Claude Code support is switched on with `SESSION_RECALL_ENABLE_CLAUDE_BACKEND=1`. The AI repair of the Codex schema is marked experimental and runs only on macOS with `sandbox-exec`. Cursor support is planned. Backends for other editors (VS Code, JetBrains, Neovim) are enabled separately following `deploy/install-other-backends.md`. The agent instruction file with `session-recall` calls is wired in by hand.
How to disable. Remove the package with `pipx uninstall auto-memory` and delete the `session-recall` commands from the agent instruction file.
FAQ
Do I need an MCP server or hooks?
No. The agent calls the CLI from its instruction file, and the commands read local data in read-only mode.
How do I enable Claude Code?
Install the package, set `SESSION_RECALL_ENABLE_CLAUDE_BACKEND=1` and run `session-recall-cc health`. Full integration is described in `deploy/install-claude-code.md`.
What does `schema-check` do?
`session-recall-codex schema-check` compares the local Codex database schema with a known version and reports drift without changing data.
Which editors are supported?
GitHub Copilot CLI by default, plus Claude Code and Codex through separate commands. VS Code, JetBrains and Neovim are enabled per the guide, and Cursor support is planned.
How do I show the agent recent sessions?
Add the `session-recall list --json --limit 10` request to its instructions with the columns you want. The agent gets a table with date, branch, project and turn count.
Discussion
No questions or reviews yet.
Related
CLI toolsMemory for agents: a Claude Code session resumes in Codex with the same decisions and open tasks.
A shared local SQLite memory for Claude Code, Codex and Hermes: every fact has a source and can be corrected or deleted
Shared local memory for AI agents: Claude Code, Codex, Cursor and others find the agreements of past sessions in it and record new ones
Local memory for agents with a review queue: SQLite, an audit log and a token ledger, one vault for Claude Code, Codex and Cursor
A local workbench for Claude Code, Codex, Pi and OpenCode: memory changes wait for your review, then an audit follows each turn
Local persistent memory for coding agents: hooks record every session, and Claude Code, Codex or Cursor recall past decisions through 54 MCP tools
README in short
The project tackles agent amnesia by turning local session stores into fast recall. It works with GitHub Copilot CLI by default and with Claude Code, Codex, VS Code, JetBrains and Neovim when enabled. Install through `pipx` or `uv`.