tribalmemory 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

tribalmemory/cli.py

@@ -26,7 +26,7 @@ TRIBAL_DIR = Path.home() / ".tribal-memory"
 CONFIG_FILE = TRIBAL_DIR / "config.yaml"
 DEFAULT_INSTANCE_ID = "default"
 
-# MCP config for Claude Code (claude_desktop_config.json)
+# MCP config for Claude Code CLI and Claude Desktop
 CLAUDE_CODE_MCP_CONFIG = {
     "mcpServers": {
         "tribal-memory": {
@@ -135,54 +135,75 @@ def cmd_init(args: argparse.Namespace) -> int:
 
 
 def _setup_claude_code_mcp(is_local: bool) -> None:
-    """Add Tribal Memory to Claude Code's MCP configuration."""
-    # Claude Code MCP config paths by platform
-    claude_config_paths = [
-        Path.home() / ".claude" / "claude_desktop_config.json",  # Claude Code CLI (all platforms)
-        Path.home() / "Library" / "Application Support" / "Claude" / "claude_desktop_config.json",  # Claude Desktop (macOS)
-        Path.home() / "AppData" / "Roaming" / "Claude" / "claude_desktop_config.json",  # Claude Desktop (Windows)
+    """Add Tribal Memory to Claude Code's MCP configuration.
+    
+    Claude Code CLI reads MCP servers from ~/.claude.json (user scope).
+    Claude Desktop reads from platform-specific claude_desktop_config.json.
+    We update both if they exist, and always ensure ~/.claude.json is set.
+    """
+    # Claude Code CLI config (primary — this is what `claude` CLI reads)
+    claude_cli_config = Path.home() / ".claude.json"
+    
+    # Claude Desktop config paths (secondary — update if they exist)
+    claude_desktop_paths = [
+        Path.home() / "Library" / "Application Support" / "Claude" / "claude_desktop_config.json",  # macOS
+        Path.home() / "AppData" / "Roaming" / "Claude" / "claude_desktop_config.json",  # Windows
+        Path.home() / ".claude" / "claude_desktop_config.json",  # Legacy / Linux
     ]
 
-    config_path = None
-    for p in claude_config_paths:
-        if p.exists():
-            config_path = p
-            break
+    mcp_entry = {
+        "command": "tribalmemory-mcp",
+        "env": {},
+    }
+    
+    if is_local:
+        mcp_entry["env"]["TRIBAL_MEMORY_EMBEDDING_API_BASE"] = "http://localhost:11434/v1"
+
+    # Always update Claude Code CLI config (~/.claude.json)
+    _update_mcp_config(claude_cli_config, mcp_entry, create_if_missing=True)
+    print(f"✅ Claude Code CLI config updated: {claude_cli_config}")
 
-    if config_path is None:
-        # Create default location
-        config_path = claude_config_paths[0]
-        config_path.parent.mkdir(parents=True, exist_ok=True)
+    # Also update Claude Desktop config (create platform-appropriate path)
+    desktop_path = _get_claude_desktop_config_path()
+    _update_mcp_config(desktop_path, mcp_entry, create_if_missing=True)
+    print(f"✅ Claude Desktop config updated: {desktop_path}")
+
+
+def _get_claude_desktop_config_path() -> Path:
+    """Get the platform-appropriate Claude Desktop config path."""
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / "Claude" / "claude_desktop_config.json"
+    elif sys.platform == "win32":
+        return Path.home() / "AppData" / "Roaming" / "Claude" / "claude_desktop_config.json"
+    else:
+        return Path.home() / ".claude" / "claude_desktop_config.json"
 
-    # Read existing config or start fresh
+
+def _update_mcp_config(
+    config_path: Path, mcp_entry: dict, create_if_missing: bool = False
+) -> None:
+    """Update an MCP config file with the tribal-memory server entry."""
     if config_path.exists():
         try:
             existing = json.loads(config_path.read_text())
         except json.JSONDecodeError as e:
-            print(
-                f"⚠️  Existing config has invalid JSON: {e}"
-            )
+            backup_path = config_path.with_suffix(".json.bak")
+            config_path.rename(backup_path)
+            print(f"⚠️  Existing config has invalid JSON: {e}")
+            print(f"   Backed up to {backup_path}")
             print(f"   Creating fresh config at {config_path}")
             existing = {}
-    else:
+    elif create_if_missing:
+        config_path.parent.mkdir(parents=True, exist_ok=True)
         existing = {}
+    else:
+        return
 
-    # Merge MCP server config
     if "mcpServers" not in existing:
         existing["mcpServers"] = {}
 
-    mcp_entry = {
-        "command": "tribalmemory-mcp",
-        "env": {},
-    }
-    
-    if is_local:
-        mcp_entry["env"]["TRIBAL_MEMORY_EMBEDDING_API_BASE"] = "http://localhost:11434/v1"
-
     existing["mcpServers"]["tribal-memory"] = mcp_entry
-
     config_path.write_text(json.dumps(existing, indent=2) + "\n")
-    print(f"✅ Claude Code MCP config updated: {config_path}")
 
 
 def _setup_codex_mcp(is_local: bool) -> None:

{tribalmemory-0.1.0.dist-info → tribalmemory-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tribalmemory
-Version: 0.1.0
+Version: 0.1.1
 Summary: Shared memory infrastructure for multi-instance AI agents
 Author-email: Joe <joe@example.com>
 License: Apache-2.0
@@ -48,12 +48,48 @@ Dynamic: license-file
 
 One memory store, many agents. Teach Claude Code something — Codex already knows it. That's not just persistence — it's **cross-agent intelligence**.
 
+<p align="center">
+  <img src="docs/assets/one-brain-two-agents.gif" alt="One Brain, Two Agents — Claude Code stores memories, Codex recalls them" width="700">
+  <br>
+  <em>Claude Code stores architecture decisions → Codex recalls them instantly</em>
+</p>
+
+[![asciinema demo](https://img.shields.io/badge/demo-asciinema-d40000)](https://asciinema.org/a/ZM74iIXzM07SV21P)
+[![PyPI](https://img.shields.io/pypi/v/tribalmemory)](https://pypi.org/project/tribalmemory/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+
 ## Why
 
 Every AI coding assistant starts fresh. Claude Code doesn't know what you told Codex. Codex doesn't know what you told Claude. You repeat yourself constantly.
 
 Tribal Memory is a shared memory server that any AI agent can connect to. Store a memory from one agent, recall it from another. It just works.
 
+## Install
+
+**macOS:**
+```bash
+# Install uv (https://docs.astral.sh/uv/)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Restart your terminal, or run:
+source ~/.zshrc
+
+# Install tribalmemory
+uv tool install tribalmemory
+```
+
+> **Why uv?** macOS blocks `pip install` into the system Python with "externally-managed-environment" errors. `uv tool install` handles isolated environments automatically.
+
+**Linux:**
+```bash
+pip install tribalmemory
+
+# Or with uv:
+# curl -LsSf https://astral.sh/uv/install.sh | sh
+# source ~/.bashrc
+# uv tool install tribalmemory
+```
+
 ## Quick Start
 
 ### Option A: Local Mode (Zero Cloud, Zero Cost)
@@ -61,8 +97,6 @@ Tribal Memory is a shared memory server that any AI agent can connect to. Store
 No API keys. No cloud. Everything runs on your machine.
 
 ```bash
-pip install tribalmemory
-
 # Set up with local Ollama embeddings
 tribalmemory init --local
 
@@ -76,8 +110,6 @@ tribalmemory serve
 ### Option B: OpenAI Embeddings
 
 ```bash
-pip install tribalmemory
-
 # Set up with OpenAI
 export OPENAI_API_KEY=sk-...
 tribalmemory init
@@ -224,19 +256,40 @@ await service.correct(
 )
 ```
 
+## Demo
+
+See cross-agent memory sharing in action:
+
+```bash
+# Start the server
+tribalmemory serve
+
+# Run the interactive demo
+./demo.sh
+```
+
+See [docs/demo-output.md](docs/demo-output.md) for example output.
+
 ## HTTP API
 
+All endpoints are under the `/v1` prefix.
+
 ```bash
 # Store a memory
-curl -X POST http://localhost:18790/memories \
+curl -X POST http://localhost:18790/v1/remember \
   -H "Content-Type: application/json" \
   -d '{"content": "The database uses Postgres 16", "tags": ["infra"]}'
 
 # Search memories
-curl "http://localhost:18790/memories/search?query=what+database&limit=5"
+curl -X POST http://localhost:18790/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query": "what database", "limit": 5}'
 
 # Get stats
-curl http://localhost:18790/stats
+curl http://localhost:18790/v1/stats
+
+# Health check
+curl http://localhost:18790/v1/health
 ```
 
 ## OpenClaw Integration

{tribalmemory-0.1.0.dist-info → tribalmemory-0.1.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
 tribalmemory/__init__.py,sha256=DNgC_ZT0lrhxsPdhXu4oeG_UdrLstYQHeKwR-U2toeY,104
-tribalmemory/cli.py,sha256=QYpHt0E-hRWK35YttlJks-xuV6kDfc6O4FrxChvZaxU,9043
+tribalmemory/cli.py,sha256=1QDcRxBBNBm1ysUv06FgwMCBHMctdJyUARuy4y0XHSs,10292
 tribalmemory/interfaces.py,sha256=W2BNYyYlY-RHTbnJn8-u1wbhfcUK5egzjUzrGexxyB0,9966
 tribalmemory/utils.py,sha256=aei7xR6OVMGkllPySA2boeHyI3D1JsHTUX1YeaZdkMY,696
 tribalmemory/a21/__init__.py,sha256=u1793uKzbWGKwiAVmCxEO9_3rdTL7QKTLhQQB8Umsl4,1181
@@ -43,9 +43,9 @@ tribalmemory/testing/fixtures.py,sha256=_zDyUVm6CQqXK1Us8CN6A95tJcmo1D7LFDktIvjO
 tribalmemory/testing/metrics.py,sha256=X1n84dJDNQXsfGV-i-MzhsWKnFgqHWIcIaQB-BUp0e0,8711
 tribalmemory/testing/mocks.py,sha256=sjLy-pq3D_T21rEvWWKM_bqw7xnchRPGLARZNfKkpGU,19788
 tribalmemory/testing/semantic_expansions.py,sha256=AbbJIXYN4EJT8WKJ7UmIlNRlv63VejbcnbzBy2z2Ofk,2953
-tribalmemory-0.1.0.dist-info/licenses/LICENSE,sha256=M8D9Xf3B6C6DFiCgAAhKcXeTscaC4cw1fhr3LHUrALU,10774
-tribalmemory-0.1.0.dist-info/METADATA,sha256=l-vV4rYIt3WFbe6Jbtzot4fZ3yTuzQA_yEXcmzdVJXs,7804
-tribalmemory-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-tribalmemory-0.1.0.dist-info/entry_points.txt,sha256=9Pep7JNCk9ifdFP4WbeCugDOjMrLVegGJ5iuvbcZ9e8,103
-tribalmemory-0.1.0.dist-info/top_level.txt,sha256=kX36ZpH4W7EWcInV4MrIudicusdz5hfkezKMZ3HCMQs,13
-tribalmemory-0.1.0.dist-info/RECORD,,
+tribalmemory-0.1.1.dist-info/licenses/LICENSE,sha256=M8D9Xf3B6C6DFiCgAAhKcXeTscaC4cw1fhr3LHUrALU,10774
+tribalmemory-0.1.1.dist-info/METADATA,sha256=IyhoTSK64QZKLTu0CjFRnmbfbvlkUGNtFNxvx2R21Ag,9239
+tribalmemory-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+tribalmemory-0.1.1.dist-info/entry_points.txt,sha256=9Pep7JNCk9ifdFP4WbeCugDOjMrLVegGJ5iuvbcZ9e8,103
+tribalmemory-0.1.1.dist-info/top_level.txt,sha256=kX36ZpH4W7EWcInV4MrIudicusdz5hfkezKMZ3HCMQs,13
+tribalmemory-0.1.1.dist-info/RECORD,,