@getopencrawl/cli-darwin-arm64 0.4.4 → 0.4.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -4
- package/bin/opencrawl +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -103,9 +103,9 @@ background upgrades; Glen's small npm entry point for agents.
|
|
|
103
103
|
|
|
104
104
|
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.
|
|
105
105
|
|
|
106
|
-
`opencrawl collect status --json` reports the
|
|
106
|
+
`opencrawl collect status --json` reports the last authenticated 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.
|
|
107
107
|
|
|
108
|
-
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
|
|
108
|
+
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 determines the current team from login and validates human attribution. Existing collectors and queued personal-scope uploads automatically use that team after updating, without reinstalling or resetting. Self-hosted users can supply `OPENCRAWL_SESSIONS_TOKEN` and `--api` for the portable receiver. See [capture architecture and limits](../docs/session-capture.md).
|
|
109
109
|
|
|
110
110
|
### Optional history import
|
|
111
111
|
|
|
@@ -156,13 +156,13 @@ subagent transcripts in those directories and only records the harness saved
|
|
|
156
156
|
locally. Cloud-only Claude chats, Cowork VM records, deleted sessions and missing
|
|
157
157
|
attachments cannot be recovered by this importer.
|
|
158
158
|
|
|
159
|
-
A one-time import reuses capture cursors,
|
|
159
|
+
A one-time import reuses capture cursors, authentication, attachment storage and
|
|
160
160
|
durable receipts. It does not turn on recurring historical scans. Rerun the
|
|
161
161
|
same approved command after an interruption; completed records are skipped.
|
|
162
162
|
Transient connection failures and HTTP 429/502/503/504 responses are retried up
|
|
163
163
|
to four times for reads and content-addressed uploads, without changing the
|
|
164
164
|
payload. Permanent rejections fail immediately. Replaying completed files
|
|
165
|
-
requires one initial
|
|
165
|
+
requires one initial authentication rather than a network request per file.
|
|
166
166
|
Approved backfills also reconcile older parser cursors to recover supported
|
|
167
167
|
inter-agent messages. Routine hooks and sync do not trigger that historical
|
|
168
168
|
reprocessing. Stable event identities prevent duplicate search documents.
|
|
@@ -205,3 +205,23 @@ personal environment above using their HTTPS receiver hostname. DELETE
|
|
|
205
205
|
credential cannot search/read, issue credentials or revoke credentials. The
|
|
206
206
|
receiver always binds the operator's fixed tenant/user, including for delegated
|
|
207
207
|
tokens. Changing that fixed identity invalidates old delegations.
|
|
208
|
+
|
|
209
|
+
## Search workspace knowledge
|
|
210
|
+
|
|
211
|
+
`opencrawl search "words" --json` queries sessions and all authorized indexed
|
|
212
|
+
connectors. Use `--source sessions|connectors`, `--match any|all|phrase`,
|
|
213
|
+
`--session-id ID` with sessions, and `--limit 1..40`. Follow `data.next` with
|
|
214
|
+
`--cursor TOKEN` and otherwise identical arguments. Pages are live and bounded;
|
|
215
|
+
inspect `coverage`, `partial`, `truncated` and `windowExhausted` before claiming
|
|
216
|
+
completeness. Results contain compact verbatim excerpts and source provenance.
|
|
217
|
+
Whitespace-equivalent passages within a session/resource are grouped; use
|
|
218
|
+
`--no-dedupe` to inspect all occurrences. `duplicateCount` counts additional
|
|
219
|
+
candidates in the current search window.
|
|
220
|
+
|
|
221
|
+
Expand a result with `opencrawl fetch <result-id> --json`. Fetch returns up to
|
|
222
|
+
6,000 characters of the original indexed passage. Continue with
|
|
223
|
+
`--offset <nextOffset> --content-version <version>`; use `--length 1..16000` to
|
|
224
|
+
control page size. A changed passage requires restarting from offset 0. Access
|
|
225
|
+
and source visibility are checked again on every read. One indexed passage may
|
|
226
|
+
be only part of a larger document or session.
|
|
227
|
+
For self-hosting, set `OPENCRAWL_TOKEN` and `--api`; otherwise saved OAuth is used.
|
package/bin/opencrawl
CHANGED