@memtensor/memmy-memory-cli

Standalone npm package for the Memmy Memory CLI.

Install

npm install -g @memtensor/memmy-memory-cli

During npm installation, the package runs node scripts/postinstall.js. The npm package is only a Node launcher shell. It downloads the platform-specific memmy-memory binary archive for the current package version and extracts it to the package bin/ directory.

Supported targets:

• darwin-arm64
• darwin-x64
• linux-arm64
• linux-x64
• windows-arm64
• windows-x64

Environment variables:

• MEMMY_MEMORY_INSTALL_SKIP_DOWNLOAD=1 skips the binary download.
• MEMMY_MEMORY_BINARY_URL=<url> uses a custom archive URL.

Default binary URL:

https://memos-test.oss-cn-shanghai.aliyuncs.com/memmy-memory-{version}-{target}.tar.gz

For the current beta package, the macOS arm64 archive name is:

memmy-memory-0.1.0-beta.1-darwin-arm64.tar.gz

If download is skipped, running memmy-memory will fail until the binary exists at bin/memmy-memory or bin/memmy-memory.exe inside the installed package.

Setup

Initialize Memory CLI config:

memmy-memory init

init writes the Memory endpoint and optional local SQLite path to the Memmy config file. The npm package does not bundle the Memory HTTP service; run the local service separately during development, or point the CLI at a cloud Memory endpoint with --url.

Install agent-side files during initialization:

memmy-memory init --agent codex

Supported agents:

• codex
• cursor
• claude
• opencode
• openclaw
• hermes

Commands

memmy-memory --help
memmy-memory --version
memmy-memory health
memmy-memory session open
memmy-memory turn start --session-id <sessionId> --query "<query>"
memmy-memory turn complete <turnId> --session-id <sessionId> --query "<query>" --answer "<answer>"
memmy-memory search "<query>"
memmy-memory add "<content>"
memmy-memory get <id>
memmy-memory delete <id>
memmy-memory raw GET /panel/overview

By default the CLI talks to http://127.0.0.1:18799. Use --user-id <id> or --user_id <id> when a single command must target a specific Memory namespace user. If omitted, the CLI reads memosMemory.userId from the configured Memmy config file. Configure the default user with memmy-agent config set app.userId <user_id>, which also writes memosMemory.userId.