@psm-memory/cli

Command line interface for shared local PSM Memory.

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

Install globally:

npm install -g @psm-memory/cli

Install the CLI and local memory runtime for normal use. npm installs @psm-memory/sdk automatically because it is a CLI dependency. A separate SDK install is only needed for custom SDK integrations or unpublished local-tarball testing.

Global install runs non-interactive setup with defaults, creates the local config and DB, downloads the default model, prepares embeddings, and verifies the local runtime. The config is 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,gemini

Gemini CLI:

psm-memory install-agent gemini

This writes cross-platform hook commands to each agent's settings file. For Codex, that is ~/.codex/hooks.json:

psm-memory hook recall
psm-memory hook remember

For Gemini CLI, the installer writes BeforeAgent and AfterAgent hooks to ~/.gemini/settings.json:

psm-memory hook recall --agent gemini
psm-memory hook remember --agent gemini

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 stored DB rows. PSM plans retrieval, SDK ranks DB/fact candidates, PSM renders concise context notes from selected rows, and SDK validation falls back to complete stored statements if rendering is invalid or ungrounded.

Enable full local PSM model I/O tracing for debugging:

psm-memory setup --trace-psm --trace-path C:\psm-memory\psm-model-io.jsonl

Or per shell:

PSM_MEMORY_TRACE=1 PSM_MEMORY_TRACE_PATH=./psm-model-io.jsonl psm-memory recall "What should I do?"

Trace files contain full prompts, raw model outputs, errors, and timings. They are local only and can include private data.

The CLI downloads the default PSM Memory Qwen 1.5B Q4_K_M GGUF model during npm installation and verifies the local runtime needed by memory commands.

If install-time setup fails, npm install fails and prints the local install log path. The log includes the failing setup step, error code, syscall, path, and destination path when Node provides them.

npm install -g @psm-memory/cli