memplex 3.2.2__tar.gz → 3.2.3__tar.gz

{memplex-3.2.2 → memplex-3.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.2
+Version: 3.2.3
 Summary: Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval
 Requires-Python: >=3.11
 License-File: LICENSE

{memplex-3.2.2 → memplex-3.2.3}/README.md

@@ -13,61 +13,67 @@
 
 ## Installation
 
-### Claude Code Plugin
+### One-Command Agent Setup
+
+No source checkout is required. The npm entrypoint matches the common
+`npx <tool> setup` pattern used by modern CLIs:
 
-**Option 1: Local plugin (for development)**
 ```bash
-# Clone and install locally
-cd plugin
-/plugin install ./plugin
+npx memplex setup
 ```
 
-**Option 2: Via marketplace**
+Install into a specific local agent:
+
 ```bash
-/plugin marketplace add ./marketplace.json
-/plugin install memplex
+npx memplex setup --agent codex --project-path "$PWD"
+npx memplex setup --agent claude-code --project-path "$PWD"
+npx memplex setup --agent openclaw --project-path "$PWD"
+npx memplex setup --agent hermes --project-path "$PWD"
 ```
 
-**Option 3: pip install**
+Install every supported agent config on this machine:
+
 ```bash
-pip install memplex
+npx memplex setup --agent all --project-path "$PWD"
 ```
 
-### From Source
+Uninstall:
 
 ```bash
-git clone https://github.com/articultur/memplex.git
-cd memplex
-pip install -e .
+npx memplex uninstall --agent all
 ```
 
-### Agent One-Command Install
+The npm wrapper creates a persistent Python environment at
+`~/.local/share/memplex/agent-venv`, installs `memplex==3.2.3`, detects local
+Codex, Claude Code, OpenClaw, and Hermes config directories/commands, then
+registers Memplex with each detected agent. It uses `uv` when available and
+falls back to `python -m venv` plus `pip`.
 
-For a machine that does not have this repository checked out, install Memplex
-into a detected local agent with:
+Python-first users can use a persistent tool install:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | bash
+uv tool install memplex==3.2.3
+memplex setup
 ```
 
-By default the script installs Memplex from GitHub into a persistent Python
-environment at `~/.local/share/memplex/agent-venv`, detects local Codex, Claude
-Code, OpenClaw, and Hermes config directories/commands, then registers Memplex
-with each detected agent. It uses `uv` when available and falls back to
-`python -m venv` plus `pip`.
+The raw hosted installer remains available for shell-only environments:
 
-Install a specific agent:
+```bash
+curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | bash
+```
+
+### Claude Code Plugin
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
-  bash -s -- --agent hermes --package memplex --project-path "$PWD" --user-id "$USER"
+memplex setup --agent claude-code
 ```
 
-Install every supported agent config on this machine:
+### From Source
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
-  bash -s -- --agent all --project-path "$PWD"
+git clone https://github.com/articultur/memplex.git
+cd memplex
+pip install -e .
 ```
 
 Uninstall:

{memplex-3.2.2 → memplex-3.2.3}/memplex/_plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memplex",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "description": "Multi-agent memory system -- persistent knowledge graph with 3-layer retrieval, compaction, and wiki",
   "author": {
     "name": "articultur"

{memplex-3.2.2 → memplex-3.2.3}/memplex/adapters/agent_installer.py

@@ -80,9 +80,33 @@ def uninstall_agent(
 
 
 def _expand_agents(agent: str) -> list[str]:
-    if (agent or "").strip().lower() == "all":
+    requested = (agent or "auto").strip().lower()
+    if requested == "all":
         return ["codex", "claude-code", "openclaw", "hermes"]
-    return [get_agent_manifest(agent)["name"]]
+    if requested == "auto":
+        detected = _detect_agents()
+        if not detected:
+            raise ValueError(
+                "No supported local agents detected. Re-run with "
+                "--agent codex|claude-code|openclaw|hermes|all."
+            )
+        return detected
+    return [get_agent_manifest(requested)["name"]]
+
+
+def _detect_agents() -> list[str]:
+    detected: list[str] = []
+    checks = [
+        ("codex", "CODEX_HOME", ".codex", "codex"),
+        ("claude-code", "CLAUDE_CONFIG_DIR", ".claude", "claude"),
+        ("openclaw", "OPENCLAW_CONFIG_DIR", ".openclaw", "openclaw"),
+        ("hermes", "HERMES_CONFIG_DIR", ".hermes", "hermes"),
+    ]
+    for name, env_name, default_name, command in checks:
+        root = Path(os.environ.get(env_name, Path.home() / default_name)).expanduser()
+        if root.exists() or shutil.which(command):
+            detected.append(name)
+    return detected
 
 
 def _install_one(
@@ -925,4 +949,4 @@ def _package_version() -> str:
     try:
         return pkg_version("memplex")
     except Exception:
-        return "3.2.2"
+        return "3.2.3"

{memplex-3.2.2 → memplex-3.2.3}/memplex/adapters/cli.py

@@ -13,9 +13,11 @@ Usage::
     memplex compact --scope project
     memplex health
     memplex stats
+    memplex setup            # Install into detected local agents
+    memplex install --agent codex
+    memplex uninstall --agent openclaw
     memplex agent install --agent all
     memplex agent uninstall --agent openclaw
-    memplex setup            # Install as Claude Code plugin
     memplex unsetup          # Uninstall Claude Code plugin
 
 Global options::
@@ -395,80 +397,25 @@ def _get_marketplace_dir() -> Path:
 
 
 def cmd_setup(args: argparse.Namespace) -> int:
-    """Install Memplex as a Claude Code plugin."""
-    if getattr(args, "uninstall", False):
-        return cmd_unsetup(args)
-
-    market_dir = _get_marketplace_dir()
-    plugin_target = market_dir / "plugin"
-
-    print("Memplex Plugin Setup")
-    print("=" * 40)
-
-    # 1. Check Python dependencies
-    print("\n[1/4] Checking dependencies...")
-    try:
-        import numpy  # noqa: F401
-        import yaml  # noqa: F401
-
-        print("  Core dependencies: OK")
-    except ImportError as e:
-        print(f"  Missing dependency: {e}")
-        print("  Run: pip install memplex[embedding]")
-        return 1
-
-    # 2. Find and copy plugin directory
-    print("\n[2/4] Installing plugin files...")
-    try:
-        source = _get_plugin_source_dir()
-    except FileNotFoundError as e:
-        print(f"  Error: {e}")
-        return 1
-
-    if plugin_target.exists():
-        shutil.rmtree(plugin_target)
-
-    def _ignore_patterns(_dir, files):
-        return [f for f in files if f == "__pycache__" or f.endswith(".pyc")]
-
-    shutil.copytree(source, plugin_target, symlinks=False, ignore=_ignore_patterns)
-    print(f"  Installed to: {plugin_target}")
-
-    # 3. Write marketplace.json
-    print("\n[3/4] Registering with Claude Code...")
-    market_json = market_dir / "marketplace.json"
-    market_dir.mkdir(parents=True, exist_ok=True)
-    market_json.write_text(_MARKETPLACE_JSON.strip() + "\n")
-    print(f"  Marketplace: {market_json}")
-
-    # 4. Write install marker
-    print("\n[4/4] Writing install marker...")
-    marker = market_dir / ".install-version"
-    from importlib.metadata import version as pkg_version
+    """Install or uninstall Memplex in local agent hosts."""
+    from memplex.adapters.agent_installer import install_agent, uninstall_agent
 
-    try:
-        ver = pkg_version("memplex")
-    except Exception:
-        ver = "3.2.2"
-    marker.write_text(
-        json.dumps(
-            {
-                "version": ver,
-                "installedAt": __import__("datetime").datetime.now().isoformat(),
-            },
-            indent=2,
+    should_uninstall = getattr(args, "uninstall", False) or args.command == "uninstall"
+    if should_uninstall:
+        result = uninstall_agent(
+            args.agent,
+            target_dir=getattr(args, "target_dir", None),
+            dry_run=getattr(args, "dry_run", False),
         )
-    )
-    print(f"  Version: {ver}")
-
-    print("\n" + "=" * 40)
-    print("Memplex plugin installed successfully!")
-    print("\nWhat was configured:")
-    print(f"  - Hooks:    {plugin_target}/hooks/hooks.json")
-    print(f"  - MCP:      {plugin_target}/.mcp.json")
-    print(f"  - Skills:   {plugin_target}/skills/*/SKILL.md")
-    print(f"  - Manifest: {plugin_target}/../.claude-plugin/plugin.json")
-    print("\nRestart Claude Code to activate the plugin.")
+    else:
+        result = install_agent(
+            args.agent,
+            target_dir=getattr(args, "target_dir", None),
+            user_id=getattr(args, "user_id", None),
+            project_path=getattr(args, "project_path", None),
+            dry_run=getattr(args, "dry_run", False),
+        )
+    print(_fmt(_dataclass_to_dict(result), args.output))
     return 0
 
 
@@ -579,7 +526,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_install.add_argument(
         "--agent",
         default="all",
-        help="Agent id: codex | claude-code | openclaw | hermes | all",
+        help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
     )
     p_agent_install.add_argument(
         "--target-dir",
@@ -598,7 +545,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_uninstall.add_argument(
         "--agent",
         default="all",
-        help="Agent id: codex | claude-code | openclaw | hermes | all",
+        help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
     )
     p_agent_uninstall.add_argument(
         "--target-dir",
@@ -629,11 +576,39 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_capture.add_argument("--assistant-message", required=True)
     p_agent_capture.add_argument("--next-prompt-hint", default=None)
 
-    # -- setup --
-    p_setup = sub.add_parser("setup", help="Install Memplex as a Claude Code plugin")
-    p_setup.add_argument(
-        "--uninstall", action="store_true", help="Uninstall the plugin"
-    )
+    # -- setup / install / uninstall --
+    def add_setup_parser(name: str, *, uninstall: bool = False):
+        help_text = (
+            "Uninstall Memplex from local agent hosts"
+            if uninstall
+            else "Set up Memplex in detected local agent hosts"
+        )
+        p_setup = sub.add_parser(name, help=help_text)
+        p_setup.add_argument(
+            "--agent",
+            default="auto",
+            help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
+        )
+        p_setup.add_argument(
+            "--target-dir",
+            default=None,
+            help="Override the selected agent config root directory",
+        )
+        p_setup.add_argument("--user-id", default=None)
+        p_setup.add_argument("--project-path", default=None)
+        p_setup.add_argument(
+            "--dry-run", action="store_true", help="Show planned files without writing"
+        )
+        if not uninstall:
+            p_setup.add_argument(
+                "--uninstall", action="store_true", help="Uninstall instead of install"
+            )
+        return p_setup
+
+    add_setup_parser("setup")
+    add_setup_parser("install")
+    add_setup_parser("stepup")
+    add_setup_parser("uninstall", uninstall=True)
 
     # -- unsetup --
     sub.add_parser("unsetup", help="Uninstall Memplex Claude Code plugin")
@@ -671,6 +646,9 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
         "stats": cmd_stats,
         "agent": cmd_agent,
         "setup": cmd_setup,
+        "install": cmd_setup,
+        "stepup": cmd_setup,
+        "uninstall": cmd_setup,
         "unsetup": cmd_unsetup,
     }
 

{memplex-3.2.2 → memplex-3.2.3}/memplex/adapters/mcp_server.py

@@ -331,7 +331,7 @@ class MCPServer:
             },
             "serverInfo": {
                 "name": "memplex",
-                "version": "3.2.2",
+                "version": "3.2.3",
             },
         }
 

{memplex-3.2.2 → memplex-3.2.3}/memplex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.2
+Version: 3.2.3
 Summary: Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval
 Requires-Python: >=3.11
 License-File: LICENSE

{memplex-3.2.2 → memplex-3.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memplex"
-version = "3.2.2"
+version = "3.2.3"
 description = "Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval"
 requires-python = ">=3.11"
 dependencies = [

{memplex-3.2.2 → memplex-3.2.3}/tests/test_agent_hot_paths.py

@@ -51,6 +51,68 @@ def test_codex_hot_path_uses_managed_mcp_block(tmp_path):
     assert 'args = ["-m", "memplex.adapters.mcp_server"]' in config
 
 
+def test_top_level_setup_auto_detects_agent_without_nested_command(tmp_path):
+    home = tmp_path / "home"
+    (home / ".codex").mkdir(parents=True)
+    result = _run_memplex(
+        [
+            "--output",
+            "json",
+            "setup",
+            "--dry-run",
+            "--project-path",
+            str(PROJECT_ROOT),
+        ],
+        env={**os.environ, "HOME": str(home), "PATH": "/usr/bin:/bin"},
+    )
+
+    assert result.returncode == 0, result.stderr
+    payload = json.loads(result.stdout)
+    assert payload[0]["agent"] == "codex"
+    assert payload[0]["action"] == "install"
+    assert payload[0]["status"] == "planned"
+
+
+def test_top_level_install_and_stepup_aliases(tmp_path):
+    for command in ("install", "stepup"):
+        result = _run_memplex(
+            [
+                "--output",
+                "json",
+                command,
+                "--agent",
+                "codex",
+                "--target-dir",
+                str(tmp_path / command),
+                "--dry-run",
+            ]
+        )
+        assert result.returncode == 0, result.stderr
+        payload = json.loads(result.stdout)
+        assert payload[0]["agent"] == "codex"
+        assert payload[0]["action"] == "install"
+
+
+def test_top_level_uninstall_alias(tmp_path):
+    result = _run_memplex(
+        [
+            "--output",
+            "json",
+            "uninstall",
+            "--agent",
+            "codex",
+            "--target-dir",
+            str(tmp_path / "codex"),
+            "--dry-run",
+        ]
+    )
+
+    assert result.returncode == 0, result.stderr
+    payload = json.loads(result.stdout)
+    assert payload[0]["agent"] == "codex"
+    assert payload[0]["action"] == "uninstall"
+
+
 def test_mcp_hot_path_initializes_over_stdio(tmp_path):
     codex_home = tmp_path / "codex"
     install = _run_memplex(

{memplex-3.2.2 → memplex-3.2.3}/tests/test_hooks.py

@@ -255,7 +255,7 @@ class TestMCPServerProtocol:
         result = mcp_server._handle_initialize({})
         assert result["protocolVersion"] == "2024-11-05"
         assert result["serverInfo"]["name"] == "memplex"
-        assert result["serverInfo"]["version"] == "3.2.2"
+        assert result["serverInfo"]["version"] == "3.2.3"
         assert "tools" in result["capabilities"]
 
     def test_tools_list_returns_definitions(self, mcp_server):
@@ -1136,14 +1136,25 @@ class TestCLI:
 
     def test_setup_command(self, tmp_path):
         r = subprocess.run(
-            [sys.executable, "-m", "memplex", "setup"],
+            [
+                sys.executable,
+                "-m",
+                "memplex",
+                "--output",
+                "json",
+                "setup",
+                "--agent",
+                "claude-code",
+            ],
             capture_output=True,
             text=True,
             timeout=30,
             env={**os.environ, "CLAUDE_CONFIG_DIR": str(tmp_path)},
         )
         assert r.returncode == 0
-        assert "Memplex plugin installed successfully" in r.stdout
+        data = json.loads(r.stdout)
+        assert data[0]["agent"] == "claude-code"
+        assert data[0]["status"] == "installed"
 
         market_dir = tmp_path / "plugins" / "marketplaces" / "articultur"
         assert (market_dir / "marketplace.json").exists()
@@ -1156,7 +1167,7 @@ class TestCLI:
     def test_unsetup_command(self, tmp_path):
         # Setup first
         subprocess.run(
-            [sys.executable, "-m", "memplex", "setup"],
+            [sys.executable, "-m", "memplex", "setup", "--agent", "claude-code"],
             capture_output=True,
             text=True,
             timeout=30,
@@ -1177,21 +1188,33 @@ class TestCLI:
 
     def test_setup_uninstall_flag(self, tmp_path):
         subprocess.run(
-            [sys.executable, "-m", "memplex", "setup"],
+            [sys.executable, "-m", "memplex", "setup", "--agent", "claude-code"],
             capture_output=True,
             text=True,
             timeout=30,
             env={**os.environ, "CLAUDE_CONFIG_DIR": str(tmp_path)},
         )
         r = subprocess.run(
-            [sys.executable, "-m", "memplex", "setup", "--uninstall"],
+            [
+                sys.executable,
+                "-m",
+                "memplex",
+                "--output",
+                "json",
+                "setup",
+                "--uninstall",
+                "--agent",
+                "claude-code",
+            ],
             capture_output=True,
             text=True,
             timeout=30,
             env={**os.environ, "CLAUDE_CONFIG_DIR": str(tmp_path)},
         )
         assert r.returncode == 0
-        assert "Memplex plugin uninstalled" in r.stdout
+        data = json.loads(r.stdout)
+        assert data[0]["agent"] == "claude-code"
+        assert data[0]["status"] == "uninstalled"
 
     def test_unsetup_when_not_installed(self, tmp_path):
         r = subprocess.run(
@@ -1270,7 +1293,7 @@ class TestPluginConfig:
             Path(PROJECT_ROOT / "plugin" / ".claude-plugin" / "plugin.json").read_text()
         )
         assert data["name"] == "memplex"
-        assert data["version"] == "3.2.2"
+        assert data["version"] == "3.2.3"
         assert "repository" in data
 
     def test_hooks_json_valid(self):

{memplex-3.2.2 → memplex-3.2.3}/tests/test_install_scripts.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import json
+import shutil
 import subprocess
 from pathlib import Path
 
@@ -13,6 +14,9 @@ NPM_AGENT_PACKAGE = PROJECT_ROOT / "npm" / "agent-installer" / "package.json"
 NPM_AGENT_BIN = PROJECT_ROOT / "npm" / "agent-installer" / "bin" / "memplex-install-agent.js"
 NPM_PACKAGE = PROJECT_ROOT / "npm" / "hermes-installer" / "package.json"
 NPM_BIN = PROJECT_ROOT / "npm" / "hermes-installer" / "bin" / "memplex-install-hermes.js"
+NPM_MEMPLEX_PACKAGE = PROJECT_ROOT / "npm" / "memplex" / "package.json"
+NPM_MEMPLEX_BIN = PROJECT_ROOT / "npm" / "memplex" / "bin" / "memplex.js"
+NODE_BIN = shutil.which("node") or "node"
 
 
 def test_installer_shell_syntax():
@@ -155,8 +159,17 @@ def test_agent_installer_all_uses_transactional_cli_path(tmp_path):
 
 
 def test_npm_hermes_installer_package_shape():
+    memplex_package = json.loads(NPM_MEMPLEX_PACKAGE.read_text())
+    assert memplex_package["name"] == "memplex"
+    assert memplex_package["version"] == "3.2.3"
+    assert memplex_package["bin"]["memplex"] == "bin/memplex.js"
+    memplex_script = NPM_MEMPLEX_BIN.read_text()
+    assert "npx memplex setup" in memplex_script
+    assert "memplex==3.2.3" in memplex_script
+
     agent_package = json.loads(NPM_AGENT_PACKAGE.read_text())
     assert agent_package["name"] == "@articultur/memplex-agent-installer"
+    assert agent_package["version"] == "0.2.0"
     assert agent_package["bin"]["memplex-install-agent"] == "bin/memplex-install-agent.js"
     agent_script = NPM_AGENT_BIN.read_text()
     assert "MEMPLEX_INSTALL_SCRIPT_URL" in agent_script
@@ -164,8 +177,63 @@ def test_npm_hermes_installer_package_shape():
 
     package = json.loads(NPM_PACKAGE.read_text())
     assert package["name"] == "@articultur/memplex-hermes-installer"
+    assert package["version"] == "0.2.0"
     assert package["bin"]["memplex-install-hermes"] == "bin/memplex-install-hermes.js"
     script = NPM_BIN.read_text()
     assert "MEMPLEX_INSTALL_SCRIPT_URL" in script
     assert "install-agent.sh" in script
     assert '"--agent", "hermes"' in script
+
+
+def test_npm_memplex_setup_runs_hosted_installer_dry_run(tmp_path):
+    result = subprocess.run(
+        [
+            NODE_BIN,
+            str(NPM_MEMPLEX_BIN),
+            "setup",
+            "--agent",
+            "codex",
+            "--dry-run",
+            "--venv-dir",
+            str(tmp_path / "venv"),
+            "--project-path",
+            "/repo/a",
+        ],
+        capture_output=True,
+        text=True,
+        timeout=10,
+        env={
+            "HOME": str(tmp_path / "home"),
+            "PATH": "/usr/bin:/bin",
+            "MEMPLEX_INSTALL_SCRIPT_URL": f"file://{AGENT_INSTALLER}",
+        },
+    )
+    assert result.returncode == 0, result.stderr
+    assert "memplex==3.2.3" in result.stdout
+    assert "-m memplex agent install --agent codex" in result.stdout
+    assert "--project-path /repo/a" in result.stdout
+
+
+def test_npm_memplex_uninstall_aliases_hosted_installer(tmp_path):
+    result = subprocess.run(
+        [
+            NODE_BIN,
+            str(NPM_MEMPLEX_BIN),
+            "uninstall",
+            "--agent",
+            "codex",
+            "--dry-run",
+            "--venv-dir",
+            str(tmp_path / "venv"),
+        ],
+        capture_output=True,
+        text=True,
+        timeout=10,
+        env={
+            "HOME": str(tmp_path / "home"),
+            "PATH": "/usr/bin:/bin",
+            "MEMPLEX_INSTALL_SCRIPT_URL": f"file://{AGENT_INSTALLER}",
+        },
+    )
+    assert result.returncode == 0, result.stderr
+    assert "-m memplex agent uninstall --agent codex" in result.stdout