tribalmemory 0.1.0__tar.gz → 0.1.1__tar.gz

{tribalmemory-0.1.0 → tribalmemory-0.1.1}/PKG-INFO

@@ -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 → tribalmemory-0.1.1}/README.md

@@ -4,12 +4,48 @@
 
 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)
@@ -17,8 +53,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
 
@@ -32,8 +66,6 @@ tribalmemory serve
 ### Option B: OpenAI Embeddings
 
 ```bash
-pip install tribalmemory
-
 # Set up with OpenAI
 export OPENAI_API_KEY=sk-...
 tribalmemory init
@@ -180,19 +212,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 → tribalmemory-0.1.1}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "tribalmemory"
-version = "0.1.0"
+version = "0.1.1"
 description = "Shared memory infrastructure for multi-instance AI agents"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{tribalmemory-0.1.0 → tribalmemory-0.1.1}/src/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 → tribalmemory-0.1.1}/src/tribalmemory.egg-info/PKG-INFO

@@ -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 → tribalmemory-0.1.1}/tests/test_cli.py

@@ -94,11 +94,11 @@ class TestInitCommand:
         assert "old config" not in config_file.read_text()
 
     def test_init_claude_code_creates_mcp_config(self, cli_env):
-        """init --claude-code should write Claude MCP config."""
+        """init --claude-code should write Claude Code CLI config (~/.claude.json)."""
         result = cmd_init(FakeArgs(claude_code=True))
 
         assert result == 0
-        claude_config = cli_env / ".claude" / "claude_desktop_config.json"
+        claude_config = cli_env / ".claude.json"
         assert claude_config.exists()
         mcp = json.loads(claude_config.read_text())
         assert "tribal-memory" in mcp["mcpServers"]
@@ -109,12 +109,58 @@ class TestInitCommand:
         result = cmd_init(FakeArgs(local=True, claude_code=True))
 
         assert result == 0
-        claude_config = cli_env / ".claude" / "claude_desktop_config.json"
+        claude_config = cli_env / ".claude.json"
         mcp = json.loads(claude_config.read_text())
         env = mcp["mcpServers"]["tribal-memory"]["env"]
         assert "TRIBAL_MEMORY_EMBEDDING_API_BASE" in env
         assert "localhost:11434" in env["TRIBAL_MEMORY_EMBEDDING_API_BASE"]
 
+    def test_init_claude_code_creates_desktop_config(self, cli_env):
+        """init --claude-code should create both CLI and Desktop configs."""
+        result = cmd_init(FakeArgs(claude_code=True))
+
+        assert result == 0
+        # CLI config
+        cli_config = cli_env / ".claude.json"
+        assert cli_config.exists()
+        cli_mcp = json.loads(cli_config.read_text())
+        assert "tribal-memory" in cli_mcp["mcpServers"]
+        # Desktop config (Linux path under fake home)
+        desktop_config = cli_env / ".claude" / "claude_desktop_config.json"
+        assert desktop_config.exists()
+        desktop_mcp = json.loads(desktop_config.read_text())
+        assert "tribal-memory" in desktop_mcp["mcpServers"]
+
+    def test_init_claude_code_backs_up_invalid_json(self, cli_env):
+        """init --claude-code should backup invalid JSON config before replacing."""
+        cli_config = cli_env / ".claude.json"
+        cli_config.write_text("not valid json {{{")
+
+        result = cmd_init(FakeArgs(claude_code=True))
+
+        assert result == 0
+        # Original should be replaced with valid config
+        mcp = json.loads(cli_config.read_text())
+        assert "tribal-memory" in mcp["mcpServers"]
+        # Backup should exist with the old content
+        backup = cli_env / ".claude.json.bak"
+        assert backup.exists()
+        assert backup.read_text() == "not valid json {{{"
+
+    def test_init_claude_code_preserves_existing_desktop_entries(self, cli_env):
+        """init --claude-code should not clobber existing Desktop MCP entries."""
+        desktop_dir = cli_env / ".claude"
+        desktop_dir.mkdir(parents=True, exist_ok=True)
+        desktop_config = desktop_dir / "claude_desktop_config.json"
+        desktop_config.write_text(json.dumps({"mcpServers": {"other": {"command": "other-cmd"}}}) + "\n")
+
+        result = cmd_init(FakeArgs(claude_code=True))
+
+        assert result == 0
+        desktop_mcp = json.loads(desktop_config.read_text())
+        assert "tribal-memory" in desktop_mcp["mcpServers"]
+        assert "other" in desktop_mcp["mcpServers"]  # preserved
+
 
 class TestCodexIntegration:
     """Tests for Codex CLI MCP integration."""