cortex-local 2.4.3__tar.gz → 2.4.5__tar.gz

{cortex_local-2.4.3 → cortex_local-2.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cortex-local
-Version: 2.4.3
+Version: 2.4.5
 Summary: Local semantic search MCP server — notes + code, embedded Qdrant, fastembed
 Requires-Python: >=3.11
 Requires-Dist: click>=8.0.0
@@ -23,7 +23,14 @@ pipx install cortex-local
 cortex install
 ```
 
-`cortex install` downloads embedding models and registers the MCP server in Claude Code. Restart Claude Code after.
+`cortex install` downloads embedding models and registers the MCP server in Claude Code with `--scope user` (available in all projects). Restart Claude Code after.
+
+## Update
+
+```bash
+pipx upgrade cortex-local
+cortex install   # re-registers MCP (idempotent)
+```
 
 ### Legacy CPUs (no SSE4.2 / X86_V2)
 
@@ -41,6 +48,8 @@ cortex install
 ```bash
 cortex index ~/notes          # index Obsidian vault
 cortex index ~/projects/myapp # index a code repo
+cortex doctor                 # check version, MCP registration, workspace, index status
+cortex uninstall              # remove MCP registration
 ```
 
 Then in Claude Code, `search_notes` and `search_code` are available as MCP tools.

{cortex_local-2.4.3 → cortex_local-2.4.5}/README.md

@@ -9,7 +9,14 @@ pipx install cortex-local
 cortex install
 ```
 
-`cortex install` downloads embedding models and registers the MCP server in Claude Code. Restart Claude Code after.
+`cortex install` downloads embedding models and registers the MCP server in Claude Code with `--scope user` (available in all projects). Restart Claude Code after.
+
+## Update
+
+```bash
+pipx upgrade cortex-local
+cortex install   # re-registers MCP (idempotent)
+```
 
 ### Legacy CPUs (no SSE4.2 / X86_V2)
 
@@ -27,6 +34,8 @@ cortex install
 ```bash
 cortex index ~/notes          # index Obsidian vault
 cortex index ~/projects/myapp # index a code repo
+cortex doctor                 # check version, MCP registration, workspace, index status
+cortex uninstall              # remove MCP registration
 ```
 
 Then in Claude Code, `search_notes` and `search_code` are available as MCP tools.

{cortex_local-2.4.3 → cortex_local-2.4.5}/cortex/cli.py

@@ -11,11 +11,12 @@ import click
 
 from .config import (
     WORKSPACES_DIR, get_active_workspace, set_active_workspace, get_workspace_dir,
-    data_dir, save_last_indexed_path,
+    data_dir, save_last_indexed_path, qdrant_path, get_config, VERSION, MODELS_DIR,
 )
 
 
 @click.group()
+@click.version_option(VERSION, prog_name="cortex")
 def cli() -> None:
     """cortex: local semantic search MCP server."""
 
@@ -160,25 +161,104 @@ def search_log_cmd(top: int) -> None:
             click.echo(f"  {q}")
 
 
+_SYSTEM_PREFIXES = [Path(p) for p in ("/usr", "/bin", "/etc", "/sbin", "/var", r"C:\Windows")]
+_SCOPE_CHOICES = click.Choice(["user", "local", "project"])
+
+
+def _is_system_dir(p: Path) -> bool:
+    r = p.resolve()
+    if r == Path("/"):
+        return True
+    return any(prefix.exists() and r.is_relative_to(prefix) for prefix in _SYSTEM_PREFIXES)
+
+
 @cli.command("install")
-def install_cmd() -> None:
+@click.option("--scope", default="user", type=_SCOPE_CHOICES, show_default=True,
+              help="MCP registration scope.")
+def install_cmd(scope: str) -> None:
     """Download embedding models and register cortex MCP in Claude Code."""
     from .embedder import pull_models as _pull
+    cwd = Path.cwd()
+    if scope != "user" and _is_system_dir(cwd):
+        click.echo(f"Warning: cwd looks like a system directory ({cwd}). Use --scope user to register globally.")
     click.echo("Downloading embedding models...")
     _pull()
-    mcp_cmd = "claude mcp add cortex --transport stdio cortex serve"
+    mcp_cmd = f"claude mcp add --scope {scope} cortex --transport stdio cortex serve"
     claude = shutil.which("claude")
     if not claude:
         click.echo("Models ready. Register MCP manually (claude not found in PATH):")
         click.echo(f"  {mcp_cmd}")
         return
     click.echo("Registering MCP server in Claude Code...")
+    subprocess.run(
+        [claude, "mcp", "remove", "cortex", "--scope", scope],
+        capture_output=True, text=True,
+    )
     result = subprocess.run(
-        [claude, "mcp", "add", "cortex", "--transport", "stdio", "cortex", "serve"],
+        [claude, "mcp", "add", "--scope", scope, "cortex", "--transport", "stdio", "cortex", "serve"],
         capture_output=True, text=True,
     )
     if result.returncode == 0:
-        click.echo("Done. cortex is ready — restart Claude Code to activate.")
+        click.echo(f"Done. cortex is ready (scope: {scope}) — restart Claude Code to activate.")
     else:
         click.echo(f"MCP registration failed. Run manually:\n  {mcp_cmd}")
         click.echo(result.stderr.strip())
+
+
+@cli.command("uninstall")
+@click.option("--scope", default="user", type=_SCOPE_CHOICES, show_default=True,
+              help="MCP registration scope to remove from.")
+def uninstall_cmd(scope: str) -> None:
+    """Remove cortex MCP registration from Claude Code."""
+    claude = shutil.which("claude")
+    if not claude:
+        click.echo(f"claude not found in PATH. Remove manually:\n  claude mcp remove cortex --scope {scope}")
+        return
+    result = subprocess.run(
+        [claude, "mcp", "remove", "cortex", "--scope", scope],
+        capture_output=True, text=True,
+    )
+    if result.returncode == 0:
+        click.echo(f"cortex MCP removed (scope: {scope}).")
+    else:
+        click.echo(f"Removal failed (scope: {scope}).")
+        click.echo(result.stderr.strip())
+
+
+@cli.command("doctor")
+def doctor_cmd() -> None:
+    """Show cortex status: version, model cache, MCP registration, workspace, index."""
+    click.echo(f"version      {VERSION}")
+
+    cache_ok = MODELS_DIR.exists() and any(MODELS_DIR.iterdir())
+    click.echo(f"model cache  {'ok' if cache_ok else 'missing — run: cortex pull-models'}")
+
+    claude = shutil.which("claude")
+    mcp_status = "claude not found in PATH"
+    if claude:
+        r = subprocess.run([claude, "mcp", "get", "cortex"], capture_output=True, text=True)
+        if r.returncode == 0:
+            detail = r.stdout.strip().splitlines()[0] if r.stdout.strip() else "registered"
+            mcp_status = detail
+        else:
+            mcp_status = "not registered — run: cortex install"
+    click.echo(f"MCP          {mcp_status}")
+
+    ws = get_active_workspace()
+    indexed = Path(qdrant_path(ws)).exists()
+    click.echo(f"workspace    {ws} ({'indexed' if indexed else 'not indexed'})")
+
+    last = get_config()["index"].get("last_path") or "(none)"
+    click.echo(f"last indexed {last}")
+
+    claude_json = Path.home() / ".claude.json"
+    if claude_json.exists():
+        try:
+            projects = json.loads(claude_json.read_text()).get("projects", {})
+            stale = [p for p, v in projects.items() if "cortex" in v.get("mcpServers", {})]
+            if stale:
+                click.echo("\nStale local registrations (run from each dir to remove):")
+                for p in stale:
+                    click.echo(f"  cd {p} && claude mcp remove cortex --scope local")
+        except Exception:
+            pass

{cortex_local-2.4.3 → cortex_local-2.4.5}/cortex/config.py

@@ -6,6 +6,7 @@ import tomllib
 from pathlib import Path
 
 CORTEX_DIR = Path.home() / ".cortex"
+MODELS_DIR = CORTEX_DIR / "models"
 WORKSPACES_DIR = CORTEX_DIR / "workspaces"
 ACTIVE_WORKSPACE_FILE = CORTEX_DIR / "active_workspace"
 CONFIG_FILE = CORTEX_DIR / "config.toml"

{cortex_local-2.4.3 → cortex_local-2.4.5}/cortex/embedder.py

@@ -5,7 +5,7 @@ import os
 os.environ.setdefault("HF_HUB_DISABLE_SYMLINKS_WARNING", "1")
 os.environ.setdefault("HF_HUB_DISABLE_IMPLICIT_TOKEN", "1")
 
-from .config import EMBED_MODEL
+from .config import EMBED_MODEL, MODELS_DIR
 
 _dense = None
 _sparse = None
@@ -30,7 +30,7 @@ def embed(text: str) -> list:
     global _dense
     if _dense is None:
         from fastembed import TextEmbedding
-        _dense = TextEmbedding(EMBED_MODEL)
+        _dense = TextEmbedding(EMBED_MODEL, cache_dir=str(MODELS_DIR))
     return list(_dense.embed([text[:4000]]))[0].tolist()
 
 
@@ -39,7 +39,7 @@ def sparse_embed(text: str) -> tuple:
     global _sparse
     if _sparse is None:
         from fastembed import SparseTextEmbedding
-        _sparse = SparseTextEmbedding("Qdrant/bm25")
+        _sparse = SparseTextEmbedding("Qdrant/bm25", cache_dir=str(MODELS_DIR))
     e = list(_sparse.embed([text[:4000]]))[0]
     return e.indices.tolist(), e.values.tolist()