@getopencrawl/cli 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # opencrawl
 
-The OpenCrawl v2 CLI. This initial release installs an automatically updating
+The OpenCrawl CLI. This initial release installs an automatically updating
 command and signs you in. **Index queries are not available yet.**
 
 Once published:
@@ -98,3 +98,12 @@ UNLICENSED pending the repository's separate public-license decision.
 Prior art: OnePatch's npm/native launcher, device login, automatic refresh and
 background upgrades; Glen's small npm entry point for agents. No query command,
 agent hooks, MCP integration or background daemon is included in this release.
+
+
+### Session capture
+
+After signing in, run `opencrawl collect install` to install Claude Code and Codex hooks and the background transcript collector. Review the commands in Codex `/hooks` or desktop Settings > Hooks. The same local configuration covers desktop and terminal sessions.
+
+`opencrawl collect status --json` reports the enrolled identity, queued uploads, last receipt and errors. `collect sync` reconciles active transcripts; `collect flush` retries queued uploads; `collect uninstall` removes OpenCrawl hooks and stops collection while preserving queued data.
+
+Messages, tool arguments/results and attachments are collected with native session IDs and a stable installation ID. System/developer prompts are excluded. The hosted service derives ownership from login. Self-hosted users can supply `OPENCRAWL_SESSIONS_TOKEN` and `--api` for the portable receiver. See [capture architecture and limits](../docs/session-capture.md).

package/bin/opencrawl.cjs

@@ -140,7 +140,7 @@ async function main(args = process.argv.slice(2)) {
   const selected = activeRoot();
   // Delegate the launcher too, so later releases can fix bootstrap behavior.
   if (selected !== ROOT) {
-    const delegated = spawnSync(process.execPath, [path.join(selected, 'bin/opencrawl.cjs'), ...args], {stdio: 'inherit', windowsHide: true});
+    const delegated = spawnSync(process.execPath, [path.join(selected, 'bin/opencrawl.cjs'), ...args], {stdio: 'inherit', windowsHide: true, env: {...process.env, OPENCRAWL_LAUNCHER: process.env.OPENCRAWL_LAUNCHER || __filename, OPENCRAWL_NODE: process.execPath}});
     if (delegated.error) throw new Error('Could not start the cached launcher.');
     return delegated.signal === 'SIGINT' ? 130 : delegated.status ?? 1;
   }
@@ -153,7 +153,7 @@ async function main(args = process.argv.slice(2)) {
     return 0;
   }
   const root = activeRoot();
-  const result = spawnSync(binary(root), args, {stdio: 'inherit', windowsHide: true});
+  const result = spawnSync(binary(root), args, {stdio: 'inherit', windowsHide: true, env: {...process.env, OPENCRAWL_LAUNCHER: process.env.OPENCRAWL_LAUNCHER || __filename, OPENCRAWL_NODE: process.execPath}});
   scheduleUpdate();
   if (result.error) throw new Error('Could not start the OpenCrawl binary. Reinstall @getopencrawl/cli.');
   if (result.signal === 'SIGINT') return 130;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getopencrawl/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "OpenCrawl CLI: sign in now, query the index as features become available",
   "type": "module",
   "license": "UNLICENSED",
@@ -24,10 +24,10 @@
     "registry": "https://registry.npmjs.org"
   },
   "optionalDependencies": {
-    "@getopencrawl/cli-darwin-arm64": "0.2.0",
-    "@getopencrawl/cli-darwin-x64": "0.2.0",
-    "@getopencrawl/cli-linux-arm64": "0.2.0",
-    "@getopencrawl/cli-linux-x64": "0.2.0",
-    "@getopencrawl/cli-win32-x64": "0.2.0"
+    "@getopencrawl/cli-darwin-arm64": "0.3.0",
+    "@getopencrawl/cli-darwin-x64": "0.3.0",
+    "@getopencrawl/cli-linux-arm64": "0.3.0",
+    "@getopencrawl/cli-linux-x64": "0.3.0",
+    "@getopencrawl/cli-win32-x64": "0.3.0"
   }
 }