add per-project installation and version bump script

Author: vykhovanets

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "rex",
       "source": "./",
       "description": "Sub-second Python symbol search for .venv packages",
-      "version": "0.1.3"
+      "version": "0.1.4"
     }
   ]
 }

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rex",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Sub-second Python symbol search for .venv packages. Find classes, functions, methods by name — faster than web search or grepping .venv.",
   "author": {
     "name": "Anton Vykhovanets",

README.md

@@ -7,23 +7,36 @@ and project source code.
 *Bonus*: MCP server for
 [Claude Code](https://github.com/anthropics/claude-code).
 
-## Install as Claude Code plugin
+## Install
+
+### Claude Code plugin
 
 ```bash
 claude plugin marketplace add vykhovanets/rex
 claude plugin install rex@rex
 ```
 
-This gives you MCP tools + SKILL.md (auto-approved
-tools, usage guidance).
+MCP tools + SKILL.md with usage guidance.
 
-### Alternative: MCP-only
+### CLI + MCP
 
 ```bash
 uv tool install rex-index
 claude mcp add rex -s user -- rex-mcp serve
 ```
 
+Rex available in every project, no per-project setup.
+
+### Project dependency
+
+```bash
+uv add rex-index
+uv run rex init-mcp
+```
+
+Adds Rex to `.mcp.json` with pre-approved tools.
+Commit both files — your team gets Rex on `uv sync`.
+
 ## How it works
 
 Rex stores a single global index at
@@ -54,6 +67,7 @@ rex index              # Build/update index
 rex index -f           # Force full rebuild
 rex index -p ./lib     # Also index extra directories
 rex clean              # Remove stale packages
+rex init-mcp           # Register MCP in .mcp.json
 ```
 
 ## MCP Tools

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rex-index"
-version = "0.1.3"
+version = "0.1.4"
 description = "Fast Python symbol search for .venv packages"
 readme = "README.md"
 license = "Apache-2.0"

src/bump.py

@@ -0,0 +1,69 @@
+"""Bump version across all Rex files.
+
+Usage: uv run src/bump.py 0.2.0
+"""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+
+TARGETS = [
+    ("src/rex/__init__.py", re.compile(r'(__version__\s*=\s*")([^"]+)(")')),
+    ("pyproject.toml", re.compile(r'(^version\s*=\s*")([^"]+)(")', re.MULTILINE)),
+    (".claude-plugin/plugin.json", re.compile(r'("version":\s*")([^"]+)(")')),
+    (".claude-plugin/marketplace.json", re.compile(r'("version":\s*")([^"]+)(")')),
+]
+
+
+def bump(new_version: str) -> None:
+    for relpath, pattern in TARGETS:
+        path = ROOT / relpath
+        text = path.read_text()
+        match = pattern.search(text)
+        if not match:
+            print(f"  SKIP {relpath} (pattern not found)")
+            continue
+        old = match.group(2)
+        if old == new_version:
+            print(f"  OK   {relpath} (already {new_version})")
+            continue
+        text = pattern.sub(rf"\g<1>{new_version}\3", text, count=1)
+        path.write_text(text)
+        print(f"  {old} → {new_version}  {relpath}")
+
+
+def _parse_version(v: str) -> tuple[int, ...]:
+    return tuple(int(x) for x in v.split("."))
+
+
+def _current_version() -> str:
+    path = ROOT / "src/rex/__init__.py"
+    match = re.search(r'__version__\s*=\s*"([^"]+)"', path.read_text())
+    return match.group(1) if match else "0.0.0"
+
+
+def main() -> None:
+    if len(sys.argv) != 2:
+        print("Usage: uv run src/bump.py <version>")
+        sys.exit(1)
+
+    version = sys.argv[1].lstrip("v")
+    if not re.match(r"^\d+\.\d+\.\d+$", version):
+        print(f"Invalid version: {version}")
+        sys.exit(1)
+
+    current = _current_version()
+    if _parse_version(version) <= _parse_version(current):
+        print(f"Error: {version} is not higher than current {current}")
+        sys.exit(1)
+
+    print(f"Bumping {current} → {version}:")
+    bump(version)
+
+
+if __name__ == "__main__":
+    main()

src/rex/__init__.py

@@ -1,3 +1,3 @@
 """Fast Python documentation browser with IDE-style navigation."""
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"

src/rex/cli.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import json
 import re
 from pathlib import Path
 
@@ -200,6 +201,45 @@ def clean() -> None:
         typer.echo("No stale packages found")
 
 
+_REX_MCP_KEY = "rex"
+_REX_MCP_CONFIG = {
+    "command": "uv",
+    "args": ["run", "rex-mcp", "serve"],
+    "autoApprove": ["rex_find", "rex_show", "rex_members"],
+}
+
+
+@app.command("init-mcp")
+def init_mcp(
+    path: Path = typer.Option(".", "-p", "--path", help="Project root with .mcp.json"),
+) -> None:
+    """Register Rex MCP server in project .mcp.json with pre-approved tools."""
+    mcp_path = path.resolve() / ".mcp.json"
+
+    if mcp_path.exists():
+        data = json.loads(mcp_path.read_text())
+        servers = data.get("mcpServers", {})
+
+        if _REX_MCP_KEY in servers:
+            existing = servers[_REX_MCP_KEY]
+            if existing == _REX_MCP_CONFIG:
+                typer.echo("Rex MCP already configured — nothing to do.")
+                raise typer.Exit(0)
+            # Update existing rex entry to latest config
+            servers[_REX_MCP_KEY] = _REX_MCP_CONFIG
+            typer.echo("Updated Rex MCP config in .mcp.json")
+        else:
+            servers[_REX_MCP_KEY] = _REX_MCP_CONFIG
+            typer.echo("Added Rex MCP to existing .mcp.json")
+
+        data["mcpServers"] = servers
+    else:
+        data = {"mcpServers": {_REX_MCP_KEY: _REX_MCP_CONFIG}}
+        typer.echo("Created .mcp.json with Rex MCP")
+
+    mcp_path.write_text(json.dumps(data, indent=2) + "\n")
+
+
 def main() -> None:
     app()