ai-browser-bridge 0.4.0 → 0.5.2

package/README.md

@@ -149,6 +149,36 @@ Paths that escape the repo root are skipped; files over 100 KB are summarized ra
 selects Chats, and returns matching Conversations across titles and message content. It scrolls
 the result overlay up to `--limit`; add `--open` to navigate the browser to the best match.
 
+**Rate-safe Project organization** — prepare one ordered plan with Conversations for any number
+of Projects (Conversation ids are preferred because they can be verified exactly):
+
+```json
+[
+  { "conversation": "11111111-1111-4111-8111-111111111111", "project": "Yoga App" },
+  { "conversation": "22222222-2222-4222-8222-222222222222", "project": "Invoices & Purchases" }
+]
+```
+
+Then validate it and start the autonomous queue:
+
+```bash
+bridge chat organize --plan @organization-plan.json --dry-run
+bridge chat organize --plan @organization-plan.json \
+  --interval 60-90 --cooldown 600 --max-attempts 4
+```
+
+The queue verifies every move from ChatGPT's loaded Project label, with the destination Project page
+as a fallback. It spaces UI operations by a fixed interval or randomized range; the defaults are a
+60-second interval, a 600-second rate-limit cooldown, and four attempts per Conversation. For large
+history cleanups, the randomized `--interval 60-90` profile above is recommended. The queue
+acknowledges ChatGPT's “Too many requests” modal before cooling down, and automatically relaunches a
+closed browser session. Neither infrastructure condition consumes a move attempt. Progress is
+persisted under `.bridge/chat-organization-queues/`; rerunning the same plan resumes pending work
+without repeating completed moves. Once the queue has started and processed or deferred one item,
+it can continue unattended without an agent watching it. Use `--restart` only when you intentionally
+want to replay the full plan. `--json` keeps the final summary on stdout and writes progress to
+stderr.
+
 ## Agents & fan-out
 
 `bridge ask` is a stable, non-interactive surface for scripts and agents — it prints to stdout, never prompts in a pipe, and `--json` emits a machine-readable payload.