contextmate 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Furmansky / MagneticStudio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# ContextMate
+
+**Zero-knowledge encrypted sync for AI agent context.**
+
+[![npm version](https://img.shields.io/npm/v/contextmate)](https://www.npmjs.com/package/contextmate)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![tests](https://img.shields.io/github/actions/workflow/status/contextmate/contextmate/test.yml?label=tests)](https://github.com/contextmate/contextmate/actions)
+
+Dropbox for your AI brain. Memories, skills, and rules -- encrypted and auto-synced across every agent and device.
+
+## Quick Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/contextmate/contextmate/main/install.sh | bash
+```
+
+## What It Does
+
+Your AI agents (Claude Code, Cursor, OpenClaw) store knowledge in markdown files -- memories, skills, rules, and identity. These files live on one machine in one agent's directory.
+
+ContextMate syncs them everywhere:
+
+- **Cross-device**: Your skills and memories follow you to every machine.
+- **Cross-agent**: Knowledge written in Claude Code flows to OpenClaw and back.
+- **Zero-knowledge encryption**: Your passphrase never leaves your device. The server stores only encrypted blobs.
+
+## How It Works
+
+**1. Install and create your encrypted vault**
+
+```bash
+contextmate init
+```
+
+**2. Connect your agents**
+
+```bash
+contextmate adapter claude init
+contextmate adapter openclaw init
+```
+
+**3. Start syncing**
+
+```bash
+contextmate daemon start
+```
+
+That's it. File changes are detected, encrypted locally, and pushed to the cloud. Other devices pull and decrypt in real time via WebSocket.
+
+## Architecture
+
+```
+Passphrase --> Argon2id --> Master Key --> HKDF branches
+                             |
+                             +-- vault key (per-file AES-256-GCM encryption)
+                             +-- auth key  (server authentication)
+                             +-- sharing key (future sharing features)
+```
+
+- All encryption happens on your device with AES-256-GCM.
+- The server only ever sees encrypted blobs.
+- Keys are derived using Argon2id (t=3, m=64MB, p=4) and HKDF-SHA256.
+
+Read the full security model at [contextmate.dev/security](https://contextmate.dev/security).
+
+## Supported Agents
+
+| Agent | Status |
+|-------|--------|
+| Claude Code | Supported |
+| OpenClaw | Supported |
+| Cursor | Coming soon |
+| ChatGPT | Coming soon |
+
+## Development
+
+### Prerequisites
+
+- Node.js 20+
+
+### Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/contextmate/contextmate.git
+cd contextmate
+
+# CLI (root)
+npm install
+npm run build
+
+# Server
+cd server
+npm install
+
+# Web dashboard
+cd web
+npm install
+
+# Marketing site
+cd www
+npm install
+```
+
+### Run Tests
+
+```bash
+npm test
+```
+
+## Project Structure
+
+```
+src/                  # CLI client
+  bin/                #   Entry point
+  cli/                #   Commands (init, status, adapter, mcp, daemon)
+  crypto/             #   Encryption (AES-256-GCM, Argon2id, HKDF, BLAKE3)
+  sync/               #   Sync engine (watcher, state, WebSocket)
+  adapters/           #   Agent adapters (Claude Code, OpenClaw)
+  mcp/                #   Local MCP server (BM25 + vector search)
+server/               # Cloud API (Hono, SQLite, WebSocket)
+web/                  # Web dashboard (React, Vite, Web Crypto API)
+www/                  # Marketing site (Astro 5, Tailwind CSS v4)
+tests/                # Test suites (Vitest)
+```
+
+## Security
+
+ContextMate is built on a zero-knowledge architecture. Your passphrase is never transmitted, and the server cannot decrypt your data. All cryptographic operations use audited libraries (`@noble/ciphers`, `@noble/hashes`).
+
+For details, see [contextmate.dev/security](https://contextmate.dev/security).
+
+## License
+
+MIT -- Copyright (c) 2026 Alex Furmansky / MagneticStudio
+
+## Links
+
+- [Website](https://contextmate.dev)
+- [Security Model](https://contextmate.dev/security)
+- [Privacy](https://contextmate.dev/privacy)
+- [GitHub](https://github.com/contextmate/contextmate)

package/dist/src/adapters/base.d.ts

@@ -0,0 +1,32 @@
+export interface AdapterOptions {
+    vaultPath: string;
+    backupsPath: string;
+}
+export interface ImportResult {
+    imported: string[];
+    skipped: string[];
+    errors: string[];
+}
+export interface SymlinkResult {
+    created: string[];
+    errors: string[];
+}
+export declare abstract class BaseAdapter {
+    protected vaultPath: string;
+    protected backupsPath: string;
+    constructor(options: AdapterOptions);
+    abstract get name(): string;
+    abstract detect(): Promise<string | null>;
+    abstract import(workspacePath: string): Promise<ImportResult>;
+    abstract createSymlinks(workspacePath: string): Promise<SymlinkResult>;
+    abstract verifySymlinks(workspacePath: string): Promise<{
+        valid: string[];
+        broken: string[];
+    }>;
+    abstract removeSymlinks(workspacePath: string): Promise<void>;
+    protected backupFile(sourcePath: string, agentName: string): Promise<void>;
+    protected safeSymlink(target: string, linkPath: string): Promise<void>;
+    protected isSymlink(path: string): Promise<boolean>;
+    protected copyToVault(sourcePath: string, vaultRelativePath: string): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,8BAAsB,WAAW;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,cAAc;IAKnC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAC7D,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9F,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAE7C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAOhE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAmB5D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;cASzC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1F"}

package/dist/src/adapters/base.js

@@ -0,0 +1,49 @@
+import { mkdir, symlink, lstat, copyFile, unlink } from 'node:fs/promises';
+import { join, dirname, relative } from 'node:path';
+export class BaseAdapter {
+    vaultPath;
+    backupsPath;
+    constructor(options) {
+        this.vaultPath = options.vaultPath;
+        this.backupsPath = options.backupsPath;
+    }
+    async backupFile(sourcePath, agentName) {
+        const relativeSrc = relative('/', sourcePath);
+        const backupDest = join(this.backupsPath, agentName, relativeSrc);
+        await mkdir(dirname(backupDest), { recursive: true });
+        await copyFile(sourcePath, backupDest);
+    }
+    async safeSymlink(target, linkPath) {
+        await mkdir(dirname(linkPath), { recursive: true });
+        try {
+            const linkStat = await lstat(linkPath);
+            if (linkStat.isSymbolicLink()) {
+                await unlink(linkPath);
+            }
+            else {
+                // Regular file exists — back it up first
+                await this.backupFile(linkPath, this.name);
+                await unlink(linkPath);
+            }
+        }
+        catch {
+            // Path does not exist, nothing to remove
+        }
+        await symlink(target, linkPath);
+    }
+    async isSymlink(path) {
+        try {
+            const stats = await lstat(path);
+            return stats.isSymbolicLink();
+        }
+        catch {
+            return false;
+        }
+    }
+    async copyToVault(sourcePath, vaultRelativePath) {
+        const dest = join(this.vaultPath, vaultRelativePath);
+        await mkdir(dirname(dest), { recursive: true });
+        await copyFile(sourcePath, dest);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/src/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,EAAE,OAAO,EAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAChI,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAkBpD,MAAM,OAAgB,WAAW;IACrB,SAAS,CAAS;IAClB,WAAW,CAAS;IAE9B,YAAY,OAAuB;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IASS,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,SAAiB;QAC9D,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,QAAgB;QAC1D,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC9B,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3C,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;QAED,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAAY;QACpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,UAAkB,EAAE,iBAAyB;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACrD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/src/adapters/claude.d.ts

@@ -0,0 +1,30 @@
+import { BaseAdapter, type ImportResult, type SymlinkResult } from './base.js';
+export declare class ClaudeCodeAdapter extends BaseAdapter {
+    get name(): string;
+    detect(): Promise<string | null>;
+    import(claudeDir: string): Promise<ImportResult>;
+    createSymlinks(claudeDir: string): Promise<SymlinkResult>;
+    verifySymlinks(claudeDir: string): Promise<{
+        valid: string[];
+        broken: string[];
+    }>;
+    removeSymlinks(claudeDir: string): Promise<void>;
+    private importSkills;
+    private importRules;
+    private importProjectMemories;
+    private importSingleFile;
+    private symlinkSkills;
+    private symlinkFiles;
+    private symlinkProjectMemories;
+    private verifySkillSymlinks;
+    private verifyFileSymlinks;
+    private verifyProjectMemorySymlinks;
+    private removeSkillSymlinks;
+    private removeFileSymlinks;
+    private removeSingleSymlink;
+    private removeProjectMemorySymlinks;
+    private discoverSkillDirs;
+    private backupDirectory;
+    private restoreDirectory;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/src/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/E,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUhC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBhD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgCzD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA2CjF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBxC,YAAY;YAiBZ,WAAW;YAwBX,qBAAqB;YAkCrB,gBAAgB;YA6BhB,aAAa;YAqCb,YAAY;YAgCZ,sBAAsB;YAwCtB,mBAAmB;YAgCnB,kBAAkB;YAiClB,2BAA2B;YA+C3B,mBAAmB;YAiCnB,kBAAkB;YAclB,mBAAmB;YAoBnB,2BAA2B;YA8B3B,iBAAiB;YAyBjB,eAAe;YAcf,gBAAgB;CAY/B"}