shardstitch 0.0.1 → 0.0.3

package/README.md

@@ -2,11 +2,58 @@
 
 **3:47pm. Mid-refactor. "Rate limit reached."**
 
-ShardStitch captures your entire AI coding session — git diff, changed files,
-dependency graph, intent — and stitches it into the next AI tool (Claude,
-Cursor, Codex, Gemini, Windsurf, Aider). 100% local, zero telemetry.
+Your code is half-written. Your plan is in your head. ShardStitch captures your entire session — git diff, changed files, dependency graph, intent — and stitches it into the next AI tool. One hotkey. Keep building like nothing happened.
 
-This npm package reserves the name; the CLI ships here soon.
+## Install
+
+```bash
+npm install shardstitch
+npx shardstitch
+```
+
+## What it does
+
+When Claude, Cursor, Codex, or Gemini locks you out mid-session, ShardStitch:
+
+1. **Scans your project** — git diff, changed files, recent commits, your notes
+2. **Builds a dependency graph** — impact radius, architecture communities — and warns the next AI what's dangerous to touch
+3. **Generates a continuation prompt** formatted for the target tool
+4. **Injects it** into the tool's pickup file (CLAUDE.md, AGENTS.md, GEMINI.md, .cursorrules) for automatic discovery
+
+Under 30 seconds, end to end.
+
+## Not just for switching tools
+
+The same trick fixes a bloated session in the *same* tool. Long AI chats accumulate a huge context tree — token burn climbs, responses slow down, and eventually you hit "Service is busy" even with quota left. ShardStitch is the clean-restart button: extract a compact context, open a fresh window of the same tool, paste, keep going.
+
+## 22 supported AI tools
+
+Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Windsurf, Aider, Kiro, Amazon Q Developer, DeepSeek, ChatGPT, OpenCode, Trae, Factory Droid, OpenClaw, VS Code Copilot, JetBrains AI, Zed AI, Replit Agent, Cody, Continue, and Tabnine.
+
+## 7 surfaces
+
+- **Web dashboard** — scan, generate, copy, download
+- **VS Code / Cursor extension** — Alt+G hotkey
+- **MCP server** — Claude Code and Cursor call it directly
+- **CLI** — `npx shardstitch` or `shardstitch capture`
+- **Desktop app** — standalone Windows exe
+- **Autosave hooks** — auto-inject on session end
+- **Local LLM failover** — Ollama, vLLM, LM Studio (zero cloud)
+
+## Key features
+
+- **Per-agent formatting** — 22 format adapters, one for each tool
+- **AI task router** — semantic matching picks the best tool for each task
+- **Persistent memory** — project decisions survive across sessions
+- **Team coordination** — shared `.shardstitch/` directory
+- **Tamper-evident audit trail** — hash-chained timeline logs
+- **Dependency graph analysis** — impact radius, god nodes, architecture communities
+
+## 100% local
+
+Your code never leaves your machine. No cloud, no telemetry, no account required. All processing happens on your hardware.
+
+## Links
 
 - Website: https://shardstitch.com
 - GitHub: https://github.com/shardstitch/shardstitch

package/cli.js

@@ -1,7 +1,72 @@
 #!/usr/bin/env node
+// ShardStitch zero-friction launcher: `npx shardstitch`
+// Finds a local install (exe or Python source) and starts the dashboard.
+// Falls back to download instructions if nothing is installed.
+
+const { spawnSync, spawn } = require("child_process");
+const { existsSync } = require("fs");
+const { join } = require("path");
+const os = require("os");
+
+const CANDIDATE_DIRS = [
+  process.env.SHARDSTITCH_HOME,
+  join(os.homedir(), "ShardStitch"),
+  join(os.homedir(), ".shardstitch", "app"),
+  process.platform === "win32" ? join(process.env.LOCALAPPDATA || "", "ShardStitch") : null,
+  process.platform === "win32" ? "C:\\Program Files\\ShardStitch" : "/opt/shardstitch",
+].filter(Boolean);
+
+function findExe() {
+  const exeName = process.platform === "win32" ? "ShardStitch.exe" : "shardstitch";
+  for (const dir of CANDIDATE_DIRS) {
+    const p = join(dir, exeName);
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+
+function findPythonApp() {
+  for (const dir of CANDIDATE_DIRS) {
+    const p = join(dir, "app.py");
+    if (existsSync(p)) return p;
+  }
+  // Also: running from a source checkout
+  const local = join(process.cwd(), "app.py");
+  if (existsSync(local)) return local;
+  return null;
+}
+
+function pythonCmd() {
+  for (const cmd of ["python", "python3", "py"]) {
+    const r = spawnSync(cmd, ["--version"], { stdio: "ignore", shell: false });
+    if (r.status === 0) return cmd;
+  }
+  return null;
+}
+
+const exe = findExe();
+if (exe) {
+  console.log("  Starting ShardStitch from " + exe);
+  spawn(exe, [], { detached: true, stdio: "ignore" }).unref();
+  console.log("  Dashboard: http://127.0.0.1:8765");
+  process.exit(0);
+}
+
+const appPy = findPythonApp();
+const py = pythonCmd();
+if (appPy && py) {
+  console.log("  Starting ShardStitch (Python) from " + appPy);
+  spawn(py, [appPy], { detached: true, stdio: "ignore", cwd: join(appPy, "..") }).unref();
+  console.log("  Dashboard: http://127.0.0.1:8765");
+  process.exit(0);
+}
+
 console.log("");
 console.log("  ShardStitch — move your AI coding session between tools.");
-console.log("  The full CLI ships here soon.");
 console.log("");
-console.log("  Get the product today: https://shardstitch.com");
+console.log("  No local install found. Get it at: https://shardstitch.com");
+console.log("  (one-time purchase, runs 100% locally, zero cloud)");
 console.log("");
+console.log("  After installing, run `npx shardstitch` again to launch.");
+console.log("");
+process.exit(1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "shardstitch",
-  "version": "0.0.1",
-  "description": "ShardStitch — move your AI coding session between Claude, Cursor, Codex & Gemini when rate limits hit. 100% local. This package reserves the name; the CLI ships here soon. Get the product at https://shardstitch.com",
+  "version": "0.0.3",
+  "description": "ShardStitch — capture your AI coding session (git diff, dependency graph, intent) and stitch it into the next tool. 22 AI tools supported. 100% local, zero telemetry. https://shardstitch.com",
   "homepage": "https://shardstitch.com",
   "bugs": { "url": "https://github.com/shardstitch/shardstitch/issues" },
   "repository": { "type": "git", "url": "git+https://github.com/shardstitch/shardstitch.git" },