@psm-memory/cli

Command line interface for shared local PSM Memory.

psm-memory setup
psm-memory remember "User prefers concise answers."
psm-memory recall "How should I answer?"
psm-memory config --path

npm install -g @psm-memory/cli runs setup. In an interactive terminal it asks for the shared memory directory, local user id, recall count, embedding settings, and daemon settings. The answers are stored in an editable config.json; run psm-memory config --path to locate it.

When daemon autostart is enabled, remember and recall start a background daemon on first use. The daemon uses an OS-assigned local port, records it in daemon.json in the memory directory, and shuts down after the configured idle timeout.

Install Codex hooks:

psm-memory install-agent codex

Install multiple agent integrations:

psm-memory install-agent codex,claude

This writes cross-platform hook commands to ~/.codex/hooks.json:

psm-memory hook recall
psm-memory hook remember

The hook commands read agent hook JSON from stdin, use the shared PSM-owned memory store, and do not depend on PowerShell or repository source paths.

Recall/context injected into agents is grounded in exact stored DB rows. PSM may plan retrieval and ranking, but it does not generate new memory facts for injection.

The CLI downloads the default PSM Memory Qwen 1.5B Q4_K_M GGUF model during npm installation.

If the install-time download is skipped or interrupted, run:

psm-memory setup

Set PSM_MEMORY_SKIP_MODEL_DOWNLOAD=1 to skip model download in CI or packaging environments. Set PSM_MEMORY_SKIP_SETUP=1 to skip install-time setup entirely.