nmem-cli

A lightweight, single-binary CLI for Nowledge Mem - AI memory management that works with any AI agent.

Now a compiled binary. As of the 0.10.0 line, nmem-cli ships the Rust-built nmem binary instead of a Python module. pip install nmem-cli downloads a platform wheel that contains the compiled CLI and puts nmem on your PATH. There is no Python runtime requirement beyond pip itself, and no Python dependencies are installed. The command surface and behavior are unchanged.

Installation

pip install nmem-cli

Or with uv:

uv tool install nmem-cli   # or: uv pip install nmem-cli

The wheel bundles the compiled nmem binary for your platform (macOS arm64/x86_64, Linux x86_64/aarch64, Windows x64). No separate toolchain or interpreter is needed.

If you use the Nowledge Mem desktop app, the nmem CLI is already bundled and can be installed from Settings → Developer Tools → Install CLI (macOS), or automatically on Linux/Windows.

Requirements

• Most commands require a running Nowledge Mem backend (default: http://127.0.0.1:14242), local or remote. Plugin inspection is local-only and does not require the backend.

Quick Start

# Check server status
nmem status

# Launch interactive TUI
nmem tui

# List memories
nmem m

# Search memories
nmem m search "python programming"

# List threads
nmem t

# Show version
nmem --version

See the full command reference and JSON/agent usage at mem.nowledge.co/docs.

For agent integrations

Run plugin inspection in the same user profile and project environment as the agent. First discover which host adapters this version of the CLI supports:

nmem --json plugins inspect --list-hosts

The response contains schema_version, local_only, and hosts, an array of canonical id values with accepted input aliases. For example, codex-cli accepts codex. Use the canonical ID to inspect one host:

nmem --json plugins inspect --host codex-cli --cwd /path/to/project

The catalog says only that this CLI can inspect that host; it does not prove that Nowledge Mem is installed, enabled, or loaded there. Decide whether to offer setup from the inspection result's installation and recommended_action, not from catalog membership or exit status alone. Older CLI releases may not have --list-hosts; probe the command and handle an unsupported-argument error rather than assuming a minimum version before the first release carrying this feature.

Connecting to a backend

# Local (default)
nmem status

# Remote, one-off
nmem --api-url https://mem.example.com status

# Remote, persisted
nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_key

Resolution priority: --api-url > NMEM_API_URL / NMEM_API_KEY > ~/.nowledge-mem/config.json > defaults.

Related

• Nowledge Mem - the full application
• This CLI is also bundled with the Nowledge Mem desktop app

Author

Nowledge Labs

License

MIT