JS Eyes is the browser extension component for DeepSeek Cowork. It communicates with the DeepSeek Cowork server via WebSocket to enable browser automation control.
💡 Let AI assistants help you operate your browser: open pages, batch fill forms, extract data, cross-site operations
- 🔗 Real-time WebSocket Communication - Persistent connection with DeepSeek Cowork server
- 📊 Tab Management - Auto-sync tab information to server
- 🎯 Remote Control - Remote open/close tabs, execute scripts, etc.
- 📄 Content Retrieval - Get page HTML, text, links, and more
- 🍪 Cookie Management - Auto-retrieve and sync page cookies
- 💉 Code Injection - Support JavaScript execution and CSS injection
- 📱 Status Monitoring - Real-time connection status and extension info
- 🏥 Health Check & Circuit Breaker - Service health monitoring with automatic circuit breaker protection
- 🔄 SSE Fallback - Auto-fallback to SSE when WebSocket connection fails
- ⚡ Rate Limiting & Deduplication - Request rate limiting and deduplication for stability
- 🔐 HMAC Authentication - Secure server communication with HMAC-SHA256 authentication
| Browser | Version | Manifest |
|---|---|---|
| Chrome | 88+ | V3 |
| Edge | 88+ | V3 |
| Firefox | 58+ | V2 |
Download the latest release from GitHub Releases:
- Chrome/Edge Extension:
js-eyes-chrome-v1.3.3.zip - Firefox Extension:
js-eyes-firefox-v1.3.3.xpi
If you prefer to install from source code:
- Clone this repository
- Follow the installation instructions below
- Open browser and navigate to
chrome://extensions/(oredge://extensions/) - Enable "Developer mode" in the top right
- Click "Load unpacked"
- Select the
chrome-extensionfolder - The extension will be installed and activated
- Open Firefox and navigate to
about:debugging - Click "This Firefox"
- Click "Load Temporary Add-on"
- Select
firefox-extension/manifest.json
If you have a signed .xpi file:
- Drag and drop into Firefox browser window
- Or open the file path in the address bar
Ensure DeepSeek Cowork is running with WebSocket server listening on port 8080 (default).
- Click the extension icon in the browser toolbar
- Check connection status in the popup
- Modify server address in settings if needed
- Click "Connect" to apply settings and connect
Auto-Connect Feature:
- Extension automatically connects on startup (if enabled)
- Auto-reconnects after disconnection (exponential backoff, unlimited retries)
- Can be enabled/disabled in settings
- Status indicator shows "Connected" (green) when successful
- Tab information automatically syncs to server
- View current tab and statistics in popup
If you encounter connection issues:
- Ensure DeepSeek Cowork is running
- Verify server address and port settings
- Check browser console for error messages
- Node.js >= 14
- Run
npm installin the project root
# Build all extensions (Firefox is signed automatically)
npm run build
# Build Chrome extension only
npm run build:chrome
# Build and sign Firefox extension
npm run build:firefox
# Bump version across all manifests
npm run bump -- 1.4.0Output files are saved to the dist/ directory. See releases/README.md for detailed documentation.
- DeepSeek Cowork - Main project
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Created by @imjszhang
Follow me on X for updates, tips, and more open source projects!
Making AI browser automation accessible to everyone
Built with ❤️ by @imjszhang
