Releases: xidik12/oculo
v0.4.4 — WebContentsView Migration
What's New
Google Sign-In Fix (Permanent) — Replaced Electron's <webview> tags with the WebContentsView API. Tabs are now top-level Chromium web contents, identical to real Chrome tabs. Google (and other sites) can no longer detect Oculo as an "embedded browser."
Changes
- TabManager — New main-process class managing WebContentsView lifecycle (create, close, activate, navigation, OAuth popups, context menus, UA cleanup)
- ViewHandle Proxy — All 2400+ lines of MCP tool handler code work unchanged via a proxy that provides the same interface as webview DOM elements
- IPC Bridge — 8 new handlers for renderer ↔ main process WebContents operations
- Bounds Reporting — ResizeObserver reports content area bounds for native view positioning
- History & OAuth — Recording and auto-close logic preserved in the new architecture
Downloads
- macOS (Apple Silicon):
Oculo-0.4.4-arm64.dmg
Full changelog: v0.4.3...v0.4.4
Oculo v0.4.3 — Cross-Platform Fix & Auth Isolation
Oculo v0.4.3 — Cross-Platform Fix & Auth Isolation
Bug Fixes
- Windows installer now works — Previous builds were ARM64 (built on M-series Mac), now correctly targets x64
- Google sign-in unblocked — Added
navigator.userAgentDataspoofing so Google no longer rejects Oculo as an insecure browser - Auth isolation — Oculo no longer reads Claude Code's keychain. Each user must sign in explicitly via Oculo's own OAuth flow
- Subscription label fixed — No longer shows hardcoded "Max" for all users; displays neutral "Sub" badge
Improvements
- Smithery.ai listing — Oculo is now indexed on Smithery with all 12 tools
- Static MCP server card — Added
/.well-known/mcp/server-card.jsonfor registry discovery - Cross-compilation fix —
beforeBuildhook skips node-pty rebuild (uses bundled prebuilts) while correctly rebuilding better-sqlite3
Downloads
| Platform | File |
|---|---|
| macOS (Apple Silicon) | Oculo-0.4.3-arm64.dmg |
| Windows (x64) Setup | Oculo Setup 0.4.3.exe |
| Windows (x64) Portable | Oculo 0.4.3.exe |
v0.4.1 — Zero-Friction Automation
What's New
UX Overhaul — Post a tweet in 1 tool call instead of 15.
Changes
- /health endpoint — Fixes bridge always deleting port file (critical bug fix)
- Bridge connection caching — 30s TTL + auto-retry on ECONNREFUSED (~2s faster per call)
- Autonomous Mode — Auto-approve browser actions; payments, passwords & shell still require confirm
- React/DraftJS contenteditable fix — 3-step fallback: clipboard paste, InputEvent, execCommand
- Better run() description — Teaches Claude to batch multi-step tasks into single calls
- --allow-all docs — Zero-friction Claude Code setup
Downloads
- macOS (Apple Silicon): Oculo-0.4.1-arm64.dmg
- Windows (installer): Oculo Setup 0.4.1.exe
- Windows (portable): Oculo 0.4.1.exe
Performance
| Metric | Before | After |
|---|---|---|
| Tool calls for a tweet | ~15 | 1-2 |
| Permission prompts | Multiple | 0 (autonomous) |
| Bridge failures | Every call | 0 |
| Latency per call | +2s | ~0s |
Oculo v0.3.0 — Fully Open-Source
Oculo is now fully open-source under the MIT license. Full codebase available to clone, modify, and contribute. New: submit action guard, Claude/Anthropic provider split, OAuth fixes, security hardening, bug fixes. macOS ARM64 only — Windows/Linux coming soon. See getoculo.com for details.
Oculo v0.2.0 — Zero Browser Limitations
What's New in v0.2.0
7 Browser Limitation Fixes
- Modifier keys on click: Ctrl+click, Shift+click, Alt+click, Meta+click now work on all elements
- Drag-and-drop: Full HTML5 DnD + low-level mouse event simulation with bezier curve movement
- Newtab title fix: Navigate from newtab now waits for page load and returns real title + snapshot
- File upload in fill: The fill tool auto-detects file path entries and routes through CDP upload
- OAuth/popup flow: Tracks opener tab, relays auth data back via postMessage, auto-closes popup
- CAPTCHA solving: CDP-based audio solver for cross-origin iframes, MutationObserver detection, solveCaptcha action with screenshot + AI vision support
- Login auto-submit + session cookies: autoLogin now clicks submit button automatically; exportCookies/importCookies bypass HttpOnly via Electron session API
Pipeline Upgrade
- run tool now supports full page snapshots, if conditional branching, and all act actions (hover, back, forward, reload, select, wait)
MCP Schema
- 62 act actions now documented in both bridge and server schemas
- New properties: from/to (drag), expression (evaluate), cookies (importCookies), autoSubmit (login)
TypeScript Fixes
- Fixed 12 pre-existing type errors across 8 files
- Eliminated TS6305 stale artifact warnings in tsconfig
- Added assets.d.ts for PNG/JPG/SVG module declarations
Build
- Private edition: Full source + all features
- Public edition: Tree-shaken build
Oculo v0.1.0 — The AI Browser
Oculo v0.1.0 — The AI Browser
Give AI eyes to see and hands to interact with the web.
Download
| Platform | File | Size |
|---|---|---|
| macOS (Apple Silicon) | Oculo-0.1.0-arm64.dmg | ~100 MB |
| macOS (ZIP) | Oculo-0.1.0-arm64-mac.zip | ~94 MB |
Windows & Linux builds coming soon.
What's Inside
- AI Chat Panel — Multi-provider (Claude, OpenAI, Gemini, Grok, OpenClaw, Ollama)
- 5 MCP Tools for Claude Code — page, act, fill, read, run, media (~30 tokens per page description)
- Media Generation — Nano Banana images (Gemini), Veo 3.1 video, DALL-E 3, Stability AI
- Smart Auth — Credential vault (macOS Keychain), auto-login, TOTP 2FA
- Privacy-First — 4-tier permission gate, PII redaction, anti-injection, audit log
- Voice Control — Whisper STT for voice commands
- Screenshots & Uploads — Capture pages, generate images, upload programmatically via CDP
Connect to Claude Code
claude mcp add oculo -- node ~/Desktop/oculo/bin/oculo-mcp.mjs
Support Development
BTC: 12yRGpUfFznzZoz4yVfZKRxLSkAwbanw2B
Website: getoculo.com
MIT License © 2026 Salakhitdinov Khidayotullo