feat: add remote Chrome DevTools Protocol support #8
+474
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Enable connecting to a remote Chrome/Edge browser via CDP for browser automation mode. This allows running Oracle on headless servers while using a browser with GUI on another machine (e.g., Windows desktop). New CLI flag: --remote-chrome <host:port> Features: - Connect to remote Chrome via CDP instead of launching local browser - Skip cookie sync (uses existing browser session) - Automatic model selection and prompt submission - Full compatibility with existing browser mode features Example usage: oracle --engine browser --remote-chrome 192.168.1.10:9222 --prompt "Hello" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Owner
|
Thanks! Interesting feature. How are file attachments handled? |
Resolve P1 issue where remote Chrome couldn't access local files. Solution: Transfer files via CDP using DataTransfer API - Read file content from CLI host filesystem - Base64 encode and inject into remote browser's DOM - Create File object via JavaScript DataTransfer API - Trigger change event on file input This enables full file attachment support in remote mode, allowing users to send local files from headless servers to ChatGPT via a remote browser on another machine. Fixes steipete#8 (P1 Badge: Remote mode cannot upload local files) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
…e transfer - Add error handling for Runtime.evaluate exceptions with exceptionDetails - Remove unused waitForAttachmentRecognition function (dead code) - Add 20MB file size limit to prevent CDP protocol issues - Expand MIME type coverage (CSV, Office docs, WebP, archives) - Dispatch both input and change events for better compatibility - Add browser API validation (File, Blob, DataTransfer, atob) - Add stricter file input element validation (instanceof, type check) All improvements suggested by GPT-5 Pro code review implemented and tested. Multi-file upload verified with 3 files (test-file.txt, remoteFileTransfer.ts, package.json).
Based on GPT-5 Pro code review feedback, address critical robustness issues: - Port validation: Add Number.isFinite() check and enforce valid range (1-65535) to prevent NaN and out-of-range port errors in browserConfig.ts - CDP error handling: Validate evalResult.result structure before accessing to prevent crashes from malformed CDP protocol responses in remoteFileTransfer.ts - User warnings: Alert users when local-only browser flags are ignored in remote Chrome mode to prevent silent misconfiguration in index.ts - Documentation: Update test script comments to reflect actual --remote-chrome flag syntax instead of deprecated split flags All fixes reviewed and rated 'Good' or 'Excellent' by GPT-5 Pro.
steipete
pushed a commit
that referenced
this pull request
Nov 18, 2025
Resolve P1 issue where remote Chrome couldn't access local files. Solution: Transfer files via CDP using DataTransfer API - Read file content from CLI host filesystem - Base64 encode and inject into remote browser's DOM - Create File object via JavaScript DataTransfer API - Trigger change event on file input This enables full file attachment support in remote mode, allowing users to send local files from headless servers to ChatGPT via a remote browser on another machine. Fixes #8 (P1 Badge: Remote mode cannot upload local files) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
suits-at
pushed a commit
to suits-at/oracle
that referenced
this pull request
Nov 18, 2025
Resolve P1 issue where remote Chrome couldn't access local files. Solution: Transfer files via CDP using DataTransfer API - Read file content from CLI host filesystem - Base64 encode and inject into remote browser's DOM - Create File object via JavaScript DataTransfer API - Trigger change event on file input This enables full file attachment support in remote mode, allowing users to send local files from headless servers to ChatGPT via a remote browser on another machine. Fixes steipete#8 (P1 Badge: Remote mode cannot upload local files) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
steipete
pushed a commit
that referenced
this pull request
Nov 19, 2025
Resolve P1 issue where remote Chrome couldn't access local files. Solution: Transfer files via CDP using DataTransfer API - Read file content from CLI host filesystem - Base64 encode and inject into remote browser's DOM - Create File object via JavaScript DataTransfer API - Trigger change event on file input This enables full file attachment support in remote mode, allowing users to send local files from headless servers to ChatGPT via a remote browser on another machine. Fixes #8 (P1 Badge: Remote mode cannot upload local files) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
steipete
pushed a commit
that referenced
this pull request
Nov 19, 2025
Resolve P1 issue where remote Chrome couldn't access local files. Solution: Transfer files via CDP using DataTransfer API - Read file content from CLI host filesystem - Base64 encode and inject into remote browser's DOM - Create File object via JavaScript DataTransfer API - Trigger change event on file input This enables full file attachment support in remote mode, allowing users to send local files from headless servers to ChatGPT via a remote browser on another machine. Fixes #8 (P1 Badge: Remote mode cannot upload local files) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Enable connecting to a remote Chrome/Edge browser via CDP for browser automation mode. This allows running Oracle on headless servers while using a browser with GUI on another machine (e.g., Windows desktop).
New CLI flag: --remote-chrome host:port
Features:
Example usage:
oracle --engine browser --remote-chrome 192.168.1.10:9222 --prompt "Hello"
🤖 Generated with Claude Code