memoryhub-cli 0.1.1__tar.gz

memoryhub_cli-0.1.1/.gitignore

@@ -0,0 +1,36 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.env
+*.env
+*.key
+*.pem
+*.p12
+*.pfx
+credentials.json
+secrets.yaml
+secrets.yml
+
+# Per-operator files that must NOT be committed (contain real credentials)
+# Each has a sibling `*.example.*` template that IS committed.
+memory-hub-mcp/deploy/users-configmap.yaml
+memory-hub-mcp/dev-users.json
+.DS_Store
+node_modules/
+.build-context/
+seed-clients.json
+
+# Added by ggshield
+.cache_ggshield
+.mcp.json
+
+NEXT_SESSION_old.md
+NEXT_SESSION.md

memoryhub_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog — memoryhub-cli
+
+All notable changes to the `memoryhub-cli` package.
+
+## [0.1.1] — 2026-04-09
+
+- Fix ruff lint errors (import sorting, `Optional` → `X | Y` annotations,
+  line length). No functional changes from 0.1.0.
+
+## [0.1.0] — 2026-04-09
+
+- Initial release. Terminal client for MemoryHub with search, read, write,
+  delete, and history commands.
+- `memoryhub config init` — interactive wizard for generating
+  `.memoryhub.yaml` and `.claude/rules/memoryhub-loading.md`.
+- `memoryhub config regenerate` — re-render rule file after editing YAML.
+- `memoryhub login` — one-time credential setup.

memoryhub_cli-0.1.1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: memoryhub-cli
+Version: 0.1.1
+Summary: CLI client for MemoryHub — centralized, governed memory for AI agents
+Project-URL: Homepage, https://github.com/redhat-ai-americas/memory-hub
+Project-URL: Repository, https://github.com/redhat-ai-americas/memory-hub
+Project-URL: Issues, https://github.com/redhat-ai-americas/memory-hub/issues
+Author: Wes Jackson
+License-Expression: Apache-2.0
+Keywords: agents,ai,cli,mcp,memory
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: memoryhub>=0.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer[all]>=0.15
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# memoryhub-cli
+
+Command-line client for MemoryHub — centralized, governed memory for AI agents.
+
+## Install
+
+```bash
+pip install memoryhub-cli
+```
+
+## Usage
+
+```bash
+# Authenticate to a MemoryHub instance
+memoryhub login
+
+# Search for memories
+memoryhub search "deployment patterns"
+
+# Read a specific memory
+memoryhub read <memory-id>
+
+# Write a new memory
+memoryhub write "Use Podman, not Docker" --scope user --weight 0.9
+
+# Set up project-level memory loading
+memoryhub config init
+memoryhub config regenerate
+```
+
+## Project configuration
+
+`memoryhub config` generates a project-local `.memoryhub.yaml` and a companion `.claude/rules/memoryhub-loading.md` rule file. Both files are meant to be committed so every contributor's agent inherits the same loading policy.
+
+`memoryhub config init` is an interactive wizard that asks about session shape, loading pattern, focus source, and retrieval defaults, then writes both files at the project root. If a legacy `.claude/rules/memoryhub-integration.md` already exists, it is backed up to `.bak` before the new rule file is written.
+
+`memoryhub config regenerate` re-renders the rule file from `.memoryhub.yaml` after you hand-edit the YAML. It reads the YAML and rewrites the Markdown rule file only; it does not modify `.memoryhub.yaml`.
+
+Per-developer connection params (`url`, `auth_url`, `client_id`, `client_secret`) live separately at `~/.config/memoryhub/config.json` and are managed by `memoryhub login`. They are not stored in `.memoryhub.yaml` and are not committed.
+
+## Further documentation
+
+The CLI is one surface of the [memory-hub](https://github.com/redhat-ai-americas/memory-hub) monorepo. For deeper context:
+
+- **[Architecture overview](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/ARCHITECTURE.md)** — System design, deployment topology
+- **[MCP server tool reference](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/mcp-server.md)** — The 15 tools the CLI wraps
+- **[Agent memory ergonomics design](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/agent-memory-ergonomics/design.md)** — Full `.memoryhub.yaml` schema, rule file templates, and session-loading patterns
+- **[Python SDK](https://pypi.org/project/memoryhub/)** — if you'd rather call the tools from Python
+
+## Links
+
+- **[GitHub repository](https://github.com/redhat-ai-americas/memory-hub)**
+- **[Issue tracker](https://github.com/redhat-ai-americas/memory-hub/issues)**
+- **[License (Apache 2.0)](https://github.com/redhat-ai-americas/memory-hub/blob/main/LICENSE)**

memoryhub_cli-0.1.1/README.md

@@ -0,0 +1,54 @@
+# memoryhub-cli
+
+Command-line client for MemoryHub — centralized, governed memory for AI agents.
+
+## Install
+
+```bash
+pip install memoryhub-cli
+```
+
+## Usage
+
+```bash
+# Authenticate to a MemoryHub instance
+memoryhub login
+
+# Search for memories
+memoryhub search "deployment patterns"
+
+# Read a specific memory
+memoryhub read <memory-id>
+
+# Write a new memory
+memoryhub write "Use Podman, not Docker" --scope user --weight 0.9
+
+# Set up project-level memory loading
+memoryhub config init
+memoryhub config regenerate
+```
+
+## Project configuration
+
+`memoryhub config` generates a project-local `.memoryhub.yaml` and a companion `.claude/rules/memoryhub-loading.md` rule file. Both files are meant to be committed so every contributor's agent inherits the same loading policy.
+
+`memoryhub config init` is an interactive wizard that asks about session shape, loading pattern, focus source, and retrieval defaults, then writes both files at the project root. If a legacy `.claude/rules/memoryhub-integration.md` already exists, it is backed up to `.bak` before the new rule file is written.
+
+`memoryhub config regenerate` re-renders the rule file from `.memoryhub.yaml` after you hand-edit the YAML. It reads the YAML and rewrites the Markdown rule file only; it does not modify `.memoryhub.yaml`.
+
+Per-developer connection params (`url`, `auth_url`, `client_id`, `client_secret`) live separately at `~/.config/memoryhub/config.json` and are managed by `memoryhub login`. They are not stored in `.memoryhub.yaml` and are not committed.
+
+## Further documentation
+
+The CLI is one surface of the [memory-hub](https://github.com/redhat-ai-americas/memory-hub) monorepo. For deeper context:
+
+- **[Architecture overview](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/ARCHITECTURE.md)** — System design, deployment topology
+- **[MCP server tool reference](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/mcp-server.md)** — The 15 tools the CLI wraps
+- **[Agent memory ergonomics design](https://github.com/redhat-ai-americas/memory-hub/blob/main/docs/agent-memory-ergonomics/design.md)** — Full `.memoryhub.yaml` schema, rule file templates, and session-loading patterns
+- **[Python SDK](https://pypi.org/project/memoryhub/)** — if you'd rather call the tools from Python
+
+## Links
+
+- **[GitHub repository](https://github.com/redhat-ai-americas/memory-hub)**
+- **[Issue tracker](https://github.com/redhat-ai-americas/memory-hub/issues)**
+- **[License (Apache 2.0)](https://github.com/redhat-ai-americas/memory-hub/blob/main/LICENSE)**

memoryhub_cli-0.1.1/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "memoryhub-cli"
+version = "0.1.1"
+description = "CLI client for MemoryHub — centralized, governed memory for AI agents"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [
+    { name = "Wes Jackson" },
+]
+keywords = ["ai", "agents", "memory", "cli", "mcp"]
+dependencies = [
+    "memoryhub>=0.1.0",
+    "typer[all]>=0.15",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Environment :: Console",
+]
+
+[project.scripts]
+memoryhub = "memoryhub_cli.main:app"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/redhat-ai-americas/memory-hub"
+Repository = "https://github.com/redhat-ai-americas/memory-hub"
+Issues = "https://github.com/redhat-ai-americas/memory-hub/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/memoryhub_cli"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 99
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]

memoryhub_cli-0.1.1/src/memoryhub_cli/__init__.py

@@ -0,0 +1,3 @@
+"""MemoryHub CLI client."""
+
+__version__ = "0.1.1"

memoryhub_cli-0.1.1/src/memoryhub_cli/config.py

@@ -0,0 +1,41 @@
+"""Configuration management for MemoryHub CLI."""
+
+import json
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".config" / "memoryhub"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+def load_config() -> dict:
+    """Load config from disk. Returns empty dict if not found."""
+    if not CONFIG_FILE.exists():
+        return {}
+    return json.loads(CONFIG_FILE.read_text())
+
+
+def save_config(config: dict) -> None:
+    """Save config to disk."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(config, indent=2) + "\n")
+    # Restrict permissions — contains secrets
+    CONFIG_FILE.chmod(0o600)
+
+
+def get_connection_params() -> dict:
+    """Get connection parameters, preferring env vars over config file.
+
+    Required keys: url, auth_url, client_id, client_secret.
+    Env vars: MEMORYHUB_URL, MEMORYHUB_AUTH_URL, MEMORYHUB_CLIENT_ID, MEMORYHUB_CLIENT_SECRET.
+    """
+    import os
+
+    config = load_config()
+    return {
+        "url": os.environ.get("MEMORYHUB_URL", config.get("url", "")),
+        "auth_url": os.environ.get("MEMORYHUB_AUTH_URL", config.get("auth_url", "")),
+        "client_id": os.environ.get("MEMORYHUB_CLIENT_ID", config.get("client_id", "")),
+        "client_secret": os.environ.get(
+            "MEMORYHUB_CLIENT_SECRET", config.get("client_secret", "")
+        ),
+    }