{"skill":{"slug":"remote-chrome","displayName":"remote-chrome","summary":"Launch, stop, restart, or check the status of a remote Chrome browser service using Xvfb, x11vnc, and noVNC. Use this whenever the user wants to start a head...","description":"---\nname: remote-chrome\ndescription: Launch, stop, restart, or check the status of a remote Chrome browser service using Xvfb, x11vnc, and noVNC. Use this whenever the user wants to start a headless Chrome browser accessible via web browser or VNC client, needs to stop the remote browser service, wants to restart the service, or asks for the current status/access URL of the remote browser. This is for running a full Chrome browser remotely with GUI access through a web interface. \n---\n\n# Open Remote Chrome Browser Management\n\nLaunch and manage a remote Chrome browser with web-based VNC access \n\n## Quick Start\n\n```bash\n# Start service (auto-checks dependencies)\n./start-remote-chrome.sh\n\n# Check status and get access info\n./status-remote-chrome.sh\n\n# Stop service\n./stop-remote-chrome.sh\n```\n\nThat's it! The start script automatically checks dependencies and provides clear installation instructions if anything is missing.\n\n## What You Get\n\n- **Web Access**: Browser-based VNC client at `http://<IP>:6080`\n- **VNC Access**: Direct VNC connection at `<IP>:5900`\n- **Remote Debugging**: Chrome DevTools at `http://<IP>:9222`\n- **Status Monitoring**: Process info, memory usage, open tabs, VNC password\n\n## Scripts\n\n| Script | Purpose |\n|--------|---------|\n| `start-remote-chrome.sh` | Start the service (with auto dependency check) |\n| `stop-remote-chrome.sh` | Stop the service |\n| `status-remote-chrome.sh` | Monitor status, memory, tabs, and get access info |\n\n## Options\n\n```bash\n# Verbose mode (see Chrome output and process details)\n./start-remote-chrome.sh -v\n\n# Foreground mode (keep script running, Ctrl+C to stop)\n./start-remote-chrome.sh -f\n\n# Custom ports\n./start-remote-chrome.sh --vnc-port 5901 --novnc-port 6081 --chrome-debug-port 9223\n\n# Custom screen resolution\n./start-remote-chrome.sh --screen-size 1920x1080x24\n\n# With proxy and bypass list\n./start-remote-chrome.sh --proxy http://proxy.example.com:8080 --proxy-bypass \"localhost,127.0.0.1,*.example.com\"\n\n# Combined options\n./start-remote-chrome.sh --screen-size 1920x1080x24 --vnc-port 5901 --novnc-port 6081 -v\n\n# Get help\n./start-remote-chrome.sh -h\n```\n\n## Configuration Parameters\n\nThe start script supports the following configurable parameters:\n\n### Port Configuration\n\n- `--vnc-port <port>`: VNC server port (default: 5900)\n- `--novnc-port <port>`: noVNC web access port (default: 6080)\n- `--chrome-debug-port <port>`: Chrome remote debugging port (default: 9222)\n\n**Example:**\n```bash\n# Use different ports to avoid conflicts\n./start-remote-chrome.sh --vnc-port 5901 --novnc-port 6081\n```\n\n### Screen Resolution\n\n- `--screen-size <WxHxD>`: Screen resolution in format `WidthxHeightxColorDepth` (default: 1600x1200x24)\n\n**Examples:**\n```bash\n# Full HD resolution with 24 color depth\n./start-remote-chrome.sh --screen-size 1920x1080x24\n```\n\n\n### Examples\n\n```bash\n# Use corporate proxy\n./start-remote-chrome.sh --proxy http://proxy.company.com:3128\n\n# Use proxy with bypass list for internal sites\n./start-remote-chrome.sh --proxy http://proxy.company.com:3128 --proxy-bypass \"*.internal.com,localhost,10.*\"\n\n# No proxy (direct connection - default behavior)\n./start-remote-chrome.sh\n```\n\n### Proxy Environment Variables\n\nThe script also respects standard proxy environment variables if set:\n- `HTTP_PROXY` / `http_proxy`\n- `HTTPS_PROXY` / `https_proxy`\n- `NO_PROXY` / `no_proxy`\n\nPriority: Command-line parameters > Environment variables > No proxy\n\n## Common Tasks\n\n### Start Service\n```bash\n./start-remote-chrome.sh\n```\nOutput includes access URLs and VNC password.\n\n### Check Status\n```bash\n./status-remote-chrome.sh\n```\nShows: process status, memory usage, open Chrome tabs, VNC password, access URLs.\n\n### Restart Service\n```bash\n./stop-remote-chrome.sh && ./start-remote-chrome.sh\n```\n\n## Integration with agent-browser\n\nControl Chrome programmatically via the `agent-browser` skill:\n\n```bash\n# 1. Start remote Chrome (with debugging port enabled)\n./start-remote-chrome.sh\n\n# 2. Connect agent-browser to Chrome\nagent-browser connect --url http://localhost:9222\n\n# 3. Navigate and interact\nagent-browser open https://example.com\nagent-browser click \"#button-id\"\nagent-browser type \"#input-field\" \"text content\"\n\n# 4. Check open tabs\n./status-remote-chrome.sh  # Shows all tabs opened by agent-browser\n```\n\n**Benefits**:\n- Visual monitoring via VNC + programmatic control via agent-browser\n- Use agent-browser for automation, VNC for visual verification\n- Debug automation scripts in real-time through web interface\n\n## References\n\nFor detailed information, see:\n- **[Installation Guide](references/installation.md)** - Dependencies and installation commands\n- **[Output Examples](references/output-examples.md)** - Sample output for all operations\n- **[Configuration](references/configuration.md)** - Script parameters, ports, troubleshooting\n\n## Need Help?\n\n- Missing dependencies? The start script will tell you exactly what to install.\n- Port conflicts? Run `./stop-remote-chrome.sh` first.\n- Want details? Check the `references/` folder for comprehensive documentation.\n","topics":["Web Browser"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":672,"installsAllTime":25,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773478697072,"updatedAt":1779078165923},"latestVersion":{"version":"1.0.0","createdAt":1773478697072,"changelog":"- Initial release of remote-chrome skill.\n- Launch, stop, restart, and check status of a remote Chrome browser service with Xvfb, x11vnc, and noVNC.\n- Provides web-based (noVNC) and direct VNC access to a full Chrome GUI remotely.\n- Start script auto-checks dependencies and provides install guidance.\n- Includes flexible options: custom ports, screen resolution, proxy support, and verbose mode.\n- Integration instructions provided for use with agent-browser skill.","license":"MIT-0"},"metadata":null,"owner":{"handle":"kelvinschen","userId":"s1761c6tgqn1q8ayrvcnhq262d8851z2","displayName":"kelvinschen","image":"https://avatars.githubusercontent.com/u/32425710?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089884936}}