Metadata-Version: 2.4
Name: nmem-cli
Version: 0.10.41
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Rust
Classifier: Topic :: Utilities
Summary: CLI and TUI for Nowledge Mem - AI memory management
Keywords: cli,tui,memory,ai,knowledge-graph,mcp
Author: Nowledge Labs
License-Expression: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://mem.nowledge.co/docs
Project-URL: Homepage, https://mem.nowledge.co/
Project-URL: Repository, https://github.com/nowledge-co/

# nmem-cli

A lightweight, single-binary CLI for [Nowledge Mem](https://mem.nowledge.co/) - 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

```bash
pip install nmem-cli
```

Or with uv:

```bash
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](https://mem.nowledge.co/), the `nmem`
CLI is already bundled and can be installed from
**Settings → Developer Tools → Install CLI** (macOS), or automatically on Linux/Windows.

## Requirements

- A running Nowledge Mem backend (default: `http://127.0.0.1:14242`), local or remote.
  `nmem` is a thin HTTP client; it talks to that backend for every operation.

## Quick Start

```bash
# 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](https://mem.nowledge.co/docs).

## Connecting to a backend

```bash
# 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](https://mem.nowledge.co/) - the full application
- This CLI is also bundled with the Nowledge Mem desktop app

## Author

[Nowledge Labs](https://github.com/nowledge-co)

## License

MIT

