Skip to content

Releases: xidik12/oculo

v0.4.4 — WebContentsView Migration

10 Mar 02:54

Choose a tag to compare

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

09 Mar 07:21

Choose a tag to compare

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.userAgentData spoofing 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.json for registry discovery
  • Cross-compilation fixbeforeBuild hook 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

09 Mar 03:02

Choose a tag to compare

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

08 Mar 05:43

Choose a tag to compare

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

28 Feb 07:30

Choose a tag to compare

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

27 Feb 06:38

Choose a tag to compare

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