{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-browser-bridge",
  "slug": "browser-bridge",
  "title": "Pack local context for a browser review",
  "summary": "Your local agent is good at doing work inside the repo. The harder part is deciding what work should happen next when the answer depends on a lot of project context. This pattern uses PackX to turn a project into a focused context packet, Oracle to move…",
  "category": "Context",
  "tags": [
    "oracle",
    "packx",
    "context"
  ],
  "sources": [
    {
      "label": "Codex workflows companion",
      "url": "https://lapis-fossil-vsbc.here.now/#browser-bridge"
    },
    {
      "label": "Published workshop recording",
      "url": "https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0"
    }
  ],
  "sourceUnits": [
    "src/content/final/oracle-packx-browser-bridge.md",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass/The Role Split",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass/Pack Deliberately",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass/Use A Real Browser Session",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass/Verify Before Trusting",
    "src/content/final/oracle-packx-browser-bridge.md#The Browser Bridge: Pack Local Context, Ask A Browser Review Pass/What To Save",
    "src/lib/content/sections.ts",
    "src/lib/content/sections.ts#browser-bridge",
    "src/lib/content/sections.ts#recordingSpans"
  ],
  "collection": "codex",
  "categoryId": "context",
  "wordCount": 611,
  "url": "/topics/codex-browser-bridge/",
  "markdownUrl": "/markdown/codex-browser-bridge.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-browser-bridge.json",
  "headings": [
    {
      "id": "the-role-split",
      "text": "The Role Split",
      "level": 2
    },
    {
      "id": "pack-deliberately",
      "text": "Pack Deliberately",
      "level": 2
    },
    {
      "id": "use-a-real-browser-session",
      "text": "Use A Real Browser Session",
      "level": 2
    },
    {
      "id": "verify-before-trusting",
      "text": "Verify Before Trusting",
      "level": 2
    },
    {
      "id": "what-to-save",
      "text": "What To Save",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Pack local context for a browser review\n\nYour local agent is good at doing work inside the repo. The harder part is deciding what work should happen next when the answer depends on a lot of project context. This pattern uses **[PackX](https://www.npmjs.com/package/packx)** to turn a project into a **focused context packet**, **[Oracle](https://github.com/johnlindquist/oracle)** to move that packet into a signed-in browser session, and a local **[Codex](https://developers.openai.com/codex)** session to turn the result back into edits, checks, and follow-up work.\n\n> It's so worth getting set up, like, it's worth sacrificing a day or two to get this locked in. So that you unlock, like, the next level of intelligence, and allow your local models to be more of workers than researchers or thinkers or reasoners.\n>\n> — John Lindquist\n\n## The Role Split\n\n- Local Codex is the worker: it inspects files, edits code, runs commands, and saves the outcome.\n- PackX prepares the context packet: it selects the project files, references, and setup material that matter for the question.\n- Oracle is the bridge: it carries the packed request into a browser session and brings the answer back.\n- The browser model is the planner, reviewer, or external critique pass: it handles a separate review lane.\n- The local loop owns the result: prompts, answers, verification commands, changed files, and unresolved questions should land back in the repo.\n\n## Pack Deliberately\n\nThe useful part is not \"send everything.\" The useful part is **choosing the files that make the question answerable** while leaving out unrelated output, secrets, logs, cookies, generated directories, and private local config.\n\nUse the bundled Oracle PackX skill when the question needs broad project context and a separate browser review pass. Keep exact flags and browser-mode call shapes in the reviewed skill. Use this mental model:\n\n```text\nproject files + references + skill docs\n  -> PackX bundle\n  -> Oracle browser session\n  -> answer returned to local Codex\n  -> edits, checks, and saved follow-up\n```\n\n## Use A Real Browser Session\n\nThe browser bridge depends on a **signed-in browser session**. That browser can run in the same environment as the repo, or in a **separate VM, container, or remote environment** so the local development loop stays usable while the browser lane runs.\n\n> I know this sounds like a very complicated setup, and it probably will take, take a while for you to figure out exactly how this would work for you and whatever system you have. But the payoff for it is immense.\n>\n> — John Lindquist\n\nKeep this boundary boring and explicit:\n\n- Do not share browser history, account sidebars, profile menus, cookies, tokens, private endpoints, hostnames, ports, or local usernames.\n- Do not make a private account setup look like a public requirement.\n- Do not promise a specific model name, price, quota, or plan behavior unless it has been checked immediately before sharing setup guidance.\n\n## Verify Before Trusting\n\nCheck the current package name, install command, browser session, hosted links, and model labels before relying on saved setup notes.\n\nBefore sharing exact install guidance, save a dated package-name check:\n\n```bash\nnpm view packx name version bin dist-tags --json\n```\n\nUse the dated check to confirm the package name, binary names, and current version. **Do not reuse install commands from old notes** without checking them.\n\n## What To Save\n\nSave enough context that the decision can be checked later:\n\n- bundle path\n- prompt\n- browser/model route used\n- answer\n- verification command\n- files changed because of the answer\n- unresolved claims or follow-ups\n\n**No saved check, no claim.**\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/#browser-bridge)\n- [Resource directory and portable download](/topics/codex-resources/)\n- [Published recording](https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0)"
}
