@codespeak/helper

Recover the AI intent from your local coding sessions and share it at 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

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 helper HTTP server on the first free port in the fixed range 54321..55230 (10 base ports × 10 offsets; see src/ports.ts)
3. Opens app.codespeak.dev in your browser; the page discovers the helper by probing the same port range against GET /healthcheck
4. You select which sessions to share and confirm — nothing leaves your machine until that point

CORS restricts which web origins can talk to the helper (app.codespeak.dev, app-dev.codespeak.dev, and localhost). Anything native on your own machine can also reach it on those ports — same trust model as Ollama or Docker Desktop's local APIs.

If a helper is already running and you launch a second one, the second instance detects the first via /healthcheck and exits cleanly.

License

Apache-2.0