memoize-xyz

Unified zero-install CLI for memoize.xyz — persistent, shared memory across Codex, Claude Code, ChatGPT, MCP clients, and custom AI agents. One token, no accounts.

npx memoize-xyz init --project
npx memoize-xyz recall "what do we know about this project?"
npx memoize-xyz remember "The API uses cursor pagination" --tags my-project

The package is one dependency-free file and uses Node's built-in fetch. Audit the source before running it if desired.

Set up

npx memoize-xyz init             # one global brain
npx memoize-xyz init --project   # this repository's brain
npx memoize-xyz doctor           # verify token, API, and installed skill

init uses an existing .memoize-token or global token when present, adopts MEMOIZE_TOKEN when set, or creates a brain. It writes token files itself with mode 0600, gitignores project tokens, installs the bundled skill, and verifies the brain. The token is never printed or passed as an argument.

Use memory

npx memoize-xyz recall "<topic>" -k 8 --wait full --actor kris/codex
npx memoize-xyz remember "<one durable fact>" --tags project --importance 0.7 --actor kris/codex
npx memoize-xyz hot
npx memoize-xyz stats
npx memoize-xyz facts --subject kris --predicate prefers --as-of 1787691600000
npx memoize-xyz expand <memory-id>
npx memoize-xyz pin <memory-id>
npx memoize-xyz pin <memory-id> --off
npx memoize-xyz forget <memory-id>

recall supports --tags a,b and --from <person>. remember supports --outcome for worked/failed lessons and --t-event <epoch-ms> for events that happened before the write.

Every authenticated command resolves its token in this order:

1. --token-file
2. MEMOIZE_TOKEN
3. nearest .memoize-token walking up from the current directory
4. ~/.config/memoize/token

--base-url overrides MEMOIZE_BASE_URL; --actor overrides MEMOIZE_ACTOR. Successful API responses are printed as JSON. Exit codes match the native Rust CLI: 1 API, 2 usage, 3 token/config, 4 network.

Installing the package globally exposes both memoize-xyz and the shorter memoize binary name. The public npm package named memoize is unrelated, so zero-install usage must remain npx memoize-xyz.

Other connection methods

OAuth-capable MCP clients can connect directly to https://memoize.xyz/mcp. Clients without OAuth can use the private https://memoize.xyz/mcp/<token> URL. Chat clients with link opening can use https://memoize.xyz/b/<token>. Raw HTTP is the final fallback.

The single canonical explanation, ordered from easiest to most manual, is memoize.xyz/agents.txt.