indelible-mcp 3.2.1 → 3.4.0

package/README.md

@@ -1,158 +1,82 @@
-# Indelible MCP Server
-
-Blockchain-backed memory for Claude Code. Save your AI conversations permanently on BSV.
-
-## Quick Start
-
-```bash
-npm install -g indelible-mcp
-indelible-mcp --show-config
-```
-
-Copy the config output and paste it into your Claude Code settings, then restart Claude Code.
-
-## Setup
-
-### 1. Sign Up at indelible.one
-
-Sign in with Google at [indelible.one](https://indelible.one). Your BSV private key (WIF) is generated automatically and shown in Settings.
-
-### 2. Install
-
-```bash
-npm install -g indelible-mcp
-```
-
-### 3. Import Your Key
-
-```bash
-indelible-mcp setup --wif=YOUR_KEY
-```
-
-Paste the WIF from your indelible.one Settings page. This saves it to `~/.indelible/config.json`.
-
-**Your key never leaves your machine.**
-
-### 4. Configure Claude Code
-
-Run:
-```bash
-indelible-mcp --show-config
-```
-
-Add the output to your Claude Code settings:
-
-```json
-{
-  "mcpServers": {
-    "indelible": {
-      "command": "indelible-mcp"
-    }
-  }
-}
-```
-
-### 5. Restart Claude Code
-
-Close and reopen VS Code (or your Claude Code client).
-
-### 6. Fund Your Wallet
-
-Send a small amount of BSV (~$0.01) to your address for transaction fees.
-
-## Tools
-
-### `setup_wallet`
-Import your BSV wallet from indelible.one. Only needed once.
-
-```
-"Import my wallet" or indelible-mcp setup --wif=YOUR_KEY
-```
-
-### `save_session`
-Save the current conversation to the blockchain.
-
-```
-"Save this session to blockchain"
-```
-
-### `load_context`
-Load previous sessions from the blockchain. Automatically includes your active AI style if one is saved.
-
-```
-"Load my previous context"
-```
-
-### `save_file`
-Save a single file to the blockchain, encrypted with your key.
-
-```
-"Save this file to the blockchain"
-```
-
-### `load_file`
-Load a file from the blockchain by transaction ID.
-
-```
-"Load file from tx abc123..."
-```
-
-### `save_project`
-Save an entire project directory to the blockchain.
-
-```
-"Save this project to the blockchain"
-```
-
-### `load_project`
-Load a project from the blockchain by transaction ID.
-
-```
-"Load project from tx abc123..."
-```
-
-### `save_style`
-Save an AI interaction style (rules/preferences) to blockchain.
-
-```
-"Save my AI style to blockchain"
-```
-
-### `load_style`
-Load an AI interaction style from blockchain. Called automatically by `load_context`.
-
-```
-"Load my AI style"
-```
-
-### `update_vault_index`
-Update the on-chain vault index with metadata for all saved files and projects.
-
-```
-"Update my vault index"
-```
-
-## How It Works
-
-1. Your conversations are encrypted with AES-256-GCM using your WIF-derived key
-2. Encrypted data is stored on the BSV blockchain via OP_RETURN
-3. Only you can decrypt your data (using your WIF)
-4. Sessions are chained together for continuity
-
-## View Your Data
-
-Visit [indelible.one](https://indelible.one) and sign in with Google to see all your saved sessions and code.
-
-## Cost
-
-~1 satoshi per byte. A typical session costs less than $0.01.
-
-## Changelog
-
-### 3.2.1
-- Security fix: removed remote fallback paths
-- All operations now route exclusively through SPV bridge
-
-## License
-
-MIT
+# Indelible MCP Server
+
+Blockchain-backed memory for Claude Code. Save your AI conversations permanently on BSV.
+
+## Quick Start
+
+```bash
+npm install -g indelible-mcp
+indelible-mcp setup
+```
+
+## Setup
+
+### 1. Install & Create Wallet
+
+```bash
+npm install -g indelible-mcp
+indelible-mcp setup
+```
+
+This generates a BSV keypair locally (your private key never leaves your machine) and registers with the Indelible server.
+
+### 2. Fund Your Wallet
+
+Send a small amount of BSV to the address shown after setup. Any BSV wallet works (HandCash, RelayX, etc.).
+
+### 3. Add MCP Config to Claude Code
+
+Run `indelible-mcp --show-config` to get your config, or add this to your Claude Code `settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "indelible": {
+      "command": "indelible-mcp"
+    }
+  }
+}
+```
+
+## Usage
+
+Once configured, just talk to Claude Code naturally:
+
+- **"Save this session to blockchain"** - saves your conversation
+- **"Load my previous context"** - restores past sessions
+- **"Delta save"** - saves only new messages (cheaper, faster)
+
+### Auto-Save & Auto-Restore
+
+Indelible automatically saves before Claude Code compacts your context, and restores your sessions after compaction. Nothing is lost.
+
+### CLI Commands
+
+```
+indelible-mcp setup              Generate wallet & register
+indelible-mcp setup --migrate    Derive API key from existing wallet
+indelible-mcp save               Save current session
+indelible-mcp save --summary XYZ Save with custom summary
+indelible-mcp load               Load context from blockchain
+indelible-mcp load --sessions=5  Load N sessions
+indelible-mcp status             Show account status
+indelible-mcp hook pre-compact   Pre-compaction save hook
+indelible-mcp hook post-compact  Post-compaction restore hook
+```
+
+## How It Works
+
+1. Your conversation is encrypted locally with your WIF key
+2. An OP_RETURN transaction is built and signed locally using `@bsv/sdk`
+3. The signed transaction is broadcast via Indelible's SPV bridge
+4. Your private key **never** leaves your machine
+
+## Security
+
+- **Zero-knowledge encryption** - your WIF-derived AES-256-GCM key encrypts all data before it touches the network
+- **Self-sovereign keys** - generated locally with `@bsv/sdk`, never transmitted
+- **Immutable storage** - once on BSV, your data cannot be altered or deleted
+
+## Learn More
+
+[indelible.one](https://indelible.one)

package/package.json

@@ -1,35 +1,39 @@
-{
-  "name": "indelible-mcp",
-  "version": "3.2.1",
-  "description": "MCP server for Indelible AI - blockchain-backed memory for Claude Code",
-  "type": "module",
-  "main": "index.js",
-  "bin": {
-    "indelible-mcp": "index.js"
-  },
-  "files": [
-    "index.js",
-    "lib/",
-    "tools/",
-    "README.md"
-  ],
-  "scripts": {
-    "start": "node index.js"
-  },
-  "keywords": [
-    "mcp",
-    "claude",
-    "indelible",
-    "blockchain",
-    "bsv",
-    "ai-memory"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "@bsv/sdk": "^1.1.23",
-    "cross-keychain": "^1.1.0",
-    "node-fetch": "^3.3.2"
-  }
-}
+{
+  "name": "indelible-mcp",
+  "version": "3.4.0",
+  "description": "Blockchain-backed memory and code storage for Claude Code. Save AI conversations and source code permanently on BSV.",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "indelible-mcp": "src/index.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "build": "bun build --compile src/index.js --outfile dist/indelible.exe",
+    "build:all": "bun build --compile --target=bun-windows-x64 src/index.js --outfile dist/indelible-win-x64.exe && bun build --compile --target=bun-linux-x64 src/index.js --outfile dist/indelible-linux-x64 && bun build --compile --target=bun-darwin-arm64 src/index.js --outfile dist/indelible-darwin-arm64"
+  },
+  "keywords": [
+    "claude-code",
+    "mcp",
+    "blockchain",
+    "bsv",
+    "memory",
+    "context",
+    "indelible",
+    "code-vault",
+    "encrypted-storage"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/indelibleai/indelible-mcp"
+  },
+  "homepage": "https://indelible.one",
+  "dependencies": {
+    "@bsv/sdk": "1.10.1",
+    "cross-keychain": "^1.1.0"
+  }
+}