@codespeak/helper 0.0.0 → 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# @codespeak/helper
+
+Recover the AI intent from your local coding sessions and share it at [app.codespeak.dev](https://app.codespeak.dev).
+
+Scans your local AI agent session files (Claude Code, Cursor), bundles them, and opens the CodeSpeak web app so you can review and publish your coding intent — without uploading anything until you explicitly confirm.
+
+## Usage
+
+```sh
+npx @codespeak/helper@latest
+```
+
+Requires Node.js 22+.
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--no-open` | Start the local server without opening a browser tab |
+| `--host=<url>` | Connect to a custom CodeSpeak instance |
+| `--dev` | Use `https://app-dev.codespeak.dev` |
+| `--dev-local` | Use `http://localhost:3000` |
+
+## How it works
+
+1. Scans well-known directories for Claude Code and Cursor session files
+2. Starts a local HTTP server (random port, token-authenticated)
+3. Opens `app.codespeak.dev` in your browser, pre-connected to the local server
+4. You select which sessions to share and confirm — nothing leaves your machine until that point
+
+## License
+
+Apache-2.0

package/bin/run.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// Wrapper that ensures --experimental-sqlite is active before loading the CLI.
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+if (!process.execArgv.includes("--experimental-sqlite")) {
+  const { execFileSync } = createRequire(import.meta.url)("child_process");
+  const __dir = dirname(fileURLToPath(import.meta.url));
+  execFileSync(process.execPath, ["--experimental-sqlite", join(__dir, "../dist/index.js"), ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: process.env,
+  });
+} else {
+  await import("../dist/index.js");
+}