memoryos-cli
v2.8.6
Published
Persistent memory for Claude Code
Downloads
319
Maintainers
Readme
memoryos-cli
Persistent memory for Claude Code. MemoryOS saves and recalls context across every session, project, and machine — so you never re-explain your stack again.
Quick Start
- Sign up at memory-os.dev and copy your API key from Settings
- Run the installer (global, one-time):
npx memoryos-cli install - Register a project (once per repo):
cd your-project npx memoryos-cli init - Use Claude Code normally — sessions are saved and recalled automatically.
Updating
npx caches packages locally, so re-running npx memoryos-cli install may use a stale version. To update to the latest release:
npx memoryos-cli@latest installYour API key, projects, and memories are preserved — only the local hooks and libraries are updated.
Commands
install
Global one-time setup. Validates your API key, installs atom hooks to ~/.claude/hooks/, MCP server to ~/.claude/memory/, shared libraries to ~/.memoryos/lib/, local BGE embedder (~130 MB), and MemoryOS instructions in ~/.claude/CLAUDE.md.
init
Run inside a project repo. Prompts for a project name, scans for README.md, package.json, pyproject.toml, Cargo.toml, or go.mod, and seeds initial memory so Claude has context from day one.
scan
Re-scan the current repository and refresh seed memories. Deletes old scan data and re-creates seed atoms from the current repo state. Useful after major refactors or dependency changes.
backfill-tokens
Walk all Claude Code session transcripts in ~/.claude/projects/, sum exact token usage per session, and update the dashboard with accurate lifetime and per-project token counts.
backfill-interceptors
Scan past transcripts to estimate how many tool calls MemoryOS interceptors would have optimized — read dedup, bash rewrite, grep/glob caching, and more. Posts baseline counters to your dashboard.
backfill-tokensandbackfill-interceptorsare optional power-user commands for populating historical data on your dashboard. Run once after installing if you want retroactive stats.
Documentation
Full docs: memory-os.dev/docs
Support
License
Proprietary — see LICENSE
