nmem-cli 0.5.9__tar.gz

nmem_cli-0.5.9/.gitignore

@@ -0,0 +1 @@
+config.env

nmem_cli-0.5.9/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: nmem-cli
+Version: 0.5.9
+Summary: CLI and TUI for Nowledge Mem - AI memory management
+Project-URL: Homepage, https://github.com/nowledge-co/mem
+Project-URL: Repository, https://github.com/nowledge-co/mem
+Project-URL: Documentation, https://github.com/nowledge-co/mem#readme
+Author: Nowledge Labs
+License-Expression: MIT
+Keywords: ai,cli,knowledge-graph,mcp,memory,tui
+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 :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.50.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# nmem-cli
+
+A lightweight CLI and TUI for [Nowledge Mem](https://github.com/nowledge-co/mem) - AI memory management that works with any AI agent.
+
+## Installation Options
+
+### Option 1: Standalone PyPI Package (Recommended for CLI-only users)
+
+```bash
+pip install nmem-cli
+```
+
+Or with uv:
+```bash
+uv pip install nmem-cli
+```
+
+### Option 2: Nowledge Mem Desktop App
+
+If you're using the [Nowledge Mem desktop app](https://github.com/nowledge-co/mem), the `nmem` CLI is bundled and can be installed via:
+- **macOS**: Settings → Install CLI (creates `/usr/local/bin/nmem`)
+- **Linux**: Automatically installed via package postinstall
+- **Windows**: Automatically added to PATH during installation
+
+The desktop app includes a bundled Python environment, so no separate Python installation is required.
+
+## Requirements
+
+- Python 3.11+ (for PyPI package)
+- A running Nowledge Mem server (default: `http://127.0.0.1:14242`)
+
+## 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
+```
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem status` | Check server connection status |
+| `nmem stats` | Show database statistics |
+| `nmem tui` | Launch interactive terminal UI |
+
+### Memory Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem m` / `nmem memories` | List recent memories |
+| `nmem m search "query"` | Search memories |
+| `nmem m show <id>` | Show memory details |
+| `nmem m add "content"` | Add a new memory |
+| `nmem m update <id>` | Update a memory |
+| `nmem m delete <id>` | Delete a memory |
+
+### Thread Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem t` / `nmem threads` | List threads |
+| `nmem t search "query"` | Search threads |
+| `nmem t show <id>` | Show thread with messages |
+| `nmem t create -t "Title" -c "content"` | Create a thread |
+| `nmem t delete <id>` | Delete a thread |
+
+## Options
+
+### Global Options
+
+```bash
+nmem --json <command>     # Output in JSON format (for scripting)
+nmem --api-url <url>      # Override API URL
+nmem --version            # Show version
+```
+
+### Search Filters (memories)
+
+```bash
+nmem m search "query" -l label1 -l label2   # Filter by labels
+nmem m search "query" -t week               # Time range: today/week/month/year
+nmem m search "query" --importance 0.7      # Minimum importance
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NMEM_API_URL` | API server URL | `http://127.0.0.1:14242` |
+
+## TUI Features
+
+The interactive TUI provides:
+
+- **Dashboard**: Overview with statistics and recent activity
+- **Memories**: Browse, search, and manage memories
+- **Threads**: View conversation threads
+- **Graph**: Explore the knowledge graph
+- **Settings**: Configure the application
+
+### TUI Keybindings
+
+| Key | Action |
+|-----|--------|
+| `1-5` | Switch tabs |
+| `/` | Focus search |
+| `?` | Show help |
+| `q` | Quit |
+
+## Examples
+
+### Script Integration (JSON mode)
+
+```bash
+# Get memories as JSON
+nmem --json m search "meeting notes" | jq '.memories[].title'
+
+# Check if server is running
+if nmem --json status | jq -e '.status == "ok"' > /dev/null; then
+    echo "Server is running"
+fi
+```
+
+### Adding Memories
+
+```bash
+# Simple memory
+nmem m add "Remember to review the PR tomorrow"
+
+# With title and importance
+nmem m add "The deployment process requires SSH access" \
+    -t "Deployment Notes" \
+    -i 0.8
+```
+
+### Creating Threads
+
+```bash
+# From content
+nmem t create -t "Debug Session" -c "Started investigating the memory leak"
+
+# From file
+nmem t create -t "Code Review" -f review-notes.md
+```
+
+## Related
+
+- [Nowledge Mem](https://github.com/nowledge-co/mem) - The full Nowledge Mem application
+- This CLI is also bundled with the main Nowledge Mem desktop app
+
+## Author
+
+[Nowledge Labs](https://github.com/nowledge-co)
+
+## License
+
+MIT

nmem_cli-0.5.9/README.md

@@ -0,0 +1,172 @@
+# nmem-cli
+
+A lightweight CLI and TUI for [Nowledge Mem](https://github.com/nowledge-co/mem) - AI memory management that works with any AI agent.
+
+## Installation Options
+
+### Option 1: Standalone PyPI Package (Recommended for CLI-only users)
+
+```bash
+pip install nmem-cli
+```
+
+Or with uv:
+```bash
+uv pip install nmem-cli
+```
+
+### Option 2: Nowledge Mem Desktop App
+
+If you're using the [Nowledge Mem desktop app](https://github.com/nowledge-co/mem), the `nmem` CLI is bundled and can be installed via:
+- **macOS**: Settings → Install CLI (creates `/usr/local/bin/nmem`)
+- **Linux**: Automatically installed via package postinstall
+- **Windows**: Automatically added to PATH during installation
+
+The desktop app includes a bundled Python environment, so no separate Python installation is required.
+
+## Requirements
+
+- Python 3.11+ (for PyPI package)
+- A running Nowledge Mem server (default: `http://127.0.0.1:14242`)
+
+## 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
+```
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem status` | Check server connection status |
+| `nmem stats` | Show database statistics |
+| `nmem tui` | Launch interactive terminal UI |
+
+### Memory Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem m` / `nmem memories` | List recent memories |
+| `nmem m search "query"` | Search memories |
+| `nmem m show <id>` | Show memory details |
+| `nmem m add "content"` | Add a new memory |
+| `nmem m update <id>` | Update a memory |
+| `nmem m delete <id>` | Delete a memory |
+
+### Thread Commands
+
+| Command | Description |
+|---------|-------------|
+| `nmem t` / `nmem threads` | List threads |
+| `nmem t search "query"` | Search threads |
+| `nmem t show <id>` | Show thread with messages |
+| `nmem t create -t "Title" -c "content"` | Create a thread |
+| `nmem t delete <id>` | Delete a thread |
+
+## Options
+
+### Global Options
+
+```bash
+nmem --json <command>     # Output in JSON format (for scripting)
+nmem --api-url <url>      # Override API URL
+nmem --version            # Show version
+```
+
+### Search Filters (memories)
+
+```bash
+nmem m search "query" -l label1 -l label2   # Filter by labels
+nmem m search "query" -t week               # Time range: today/week/month/year
+nmem m search "query" --importance 0.7      # Minimum importance
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NMEM_API_URL` | API server URL | `http://127.0.0.1:14242` |
+
+## TUI Features
+
+The interactive TUI provides:
+
+- **Dashboard**: Overview with statistics and recent activity
+- **Memories**: Browse, search, and manage memories
+- **Threads**: View conversation threads
+- **Graph**: Explore the knowledge graph
+- **Settings**: Configure the application
+
+### TUI Keybindings
+
+| Key | Action |
+|-----|--------|
+| `1-5` | Switch tabs |
+| `/` | Focus search |
+| `?` | Show help |
+| `q` | Quit |
+
+## Examples
+
+### Script Integration (JSON mode)
+
+```bash
+# Get memories as JSON
+nmem --json m search "meeting notes" | jq '.memories[].title'
+
+# Check if server is running
+if nmem --json status | jq -e '.status == "ok"' > /dev/null; then
+    echo "Server is running"
+fi
+```
+
+### Adding Memories
+
+```bash
+# Simple memory
+nmem m add "Remember to review the PR tomorrow"
+
+# With title and importance
+nmem m add "The deployment process requires SSH access" \
+    -t "Deployment Notes" \
+    -i 0.8
+```
+
+### Creating Threads
+
+```bash
+# From content
+nmem t create -t "Debug Session" -c "Started investigating the memory leak"
+
+# From file
+nmem t create -t "Code Review" -f review-notes.md
+```
+
+## Related
+
+- [Nowledge Mem](https://github.com/nowledge-co/mem) - The full Nowledge Mem application
+- This CLI is also bundled with the main Nowledge Mem desktop app
+
+## Author
+
+[Nowledge Labs](https://github.com/nowledge-co)
+
+## License
+
+MIT

nmem_cli-0.5.9/pyproject.toml

@@ -0,0 +1,79 @@
+[project]
+name = "nmem-cli"
+version = "0.5.9"
+description = "CLI and TUI for Nowledge Mem - AI memory management"
+authors = [
+    {name = "Nowledge Labs"}
+]
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+keywords = ["cli", "tui", "memory", "ai", "knowledge-graph", "mcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+dependencies = [
+    # CLI framework and output
+    "rich>=13.0.0",
+    # HTTP client for API communication
+    "httpx>=0.25.0",
+    # TUI framework
+    "textual>=0.50.0",
+    # Clipboard support
+    "pyperclip>=1.9.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+nmem = "nmem_cli:main"
+
+[project.urls]
+Homepage = "https://github.com/nowledge-co/mem"
+Repository = "https://github.com/nowledge-co/mem"
+Documentation = "https://github.com/nowledge-co/mem#readme"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nmem_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+]
+
+[tool.black]
+line-length = 88
+target-version = ['py311']
+
+[tool.ruff]
+target-version = "py311"
+line-length = 88
+lint.select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]

nmem_cli-0.5.9/src/nmem_cli/__init__.py

@@ -0,0 +1,24 @@
+"""
+nmem-cli - CLI and TUI for Nowledge Mem
+
+A lightweight command-line interface and terminal UI for interacting
+with the Nowledge Mem server.
+
+Usage:
+    nmem status          Check server connection
+    nmem stats           Show database statistics
+    nmem tui             Launch interactive TUI
+    nmem m               List memories (alias for 'memories')
+    nmem m search "q"    Search memories
+    nmem t               List threads (alias for 'threads')
+
+Environment:
+    NMEM_API_URL         Override API URL (default: http://127.0.0.1:14242)
+"""
+
+__version__ = "0.5.9"
+__author__ = "Nowledge Labs"
+
+from .cli import main
+
+__all__ = ["__version__", "main"]