Omniscio

Embedded Browser

Omniscio's built-in web browser, opened from the sidebar as a panel of its own — what the toolbar does, how cookies and logins persist between visits, and the limits that make it a quick-look surface rather than a replacement for your browser.

On this page

What it is

Omniscio ships a built-in web browser as a sidebar virtual project. Click Browser in the Omniscio sidebar group (sky-blue Globe icon, sits alphabetically between Automations and CLI Tools) and the right pane swaps to a full-width browser surface — no sessions list, no chat composer, just a toolbar and a single page view.

It's intended for quick lookups inside Omniscio without alt-tabbing to Chrome: reading docs, signing into a service whose token you want available for future visits, peeking at a Google Doc or a dashboard, etc. It is not a replacement for your real browser — there are no tabs, no bookmarks, no extensions, no DevTools.

Where to find it

What you see

A simple Chrome-style toolbar across the top of the panel, then the live web page below:

  • Back / Forward arrows — disabled when there's no history in that direction.
  • Reload — spins into a Stop button while a page is loading.
  • Home — globe icon, jumps to Google.
  • Address bar — type a URL (https://docs.google.com), a bare host (example.com, localhost:3000), or any free-form text. Free-form text is sent to Google as a search query. Press Enter to navigate; the bar auto-selects on focus so you can just start typing.

While the first page is still loading, a centered "Loading browser…" spinner overlays the pane. It disappears as soon as the webview's DOM is ready.

In a session's side panel

Each session can also show a Browser tab in its side panel — a smaller browser for that session (for example the dev server its agent started). It uses the same sign-ins as this screen, opens only web addresses, and keeps its keys and pop-ups to itself: Ctrl+W inside it closes the panel's tab, never one here. Zoom keys do nothing there, because zoom is shared with this screen for each site.

How it behaves

Device sizes and rotation

The Device sizes button (a phone icon) in the Browser toolbar, and in a session's side-panel Browser tab, shows the current page at a phone or tablet size — seventeen presets from Chrome's developer tools, from iPhone SE to Nest Hub Max — or a custom width × height (whole pixels, 240 to 3840 a side, no bigger than a 4K screen). Rotate swaps the sides; the × goes back to filling the panel. A size bigger than the panel is scaled down to fit, never cut off, and the page lays out at exactly the width you chose, whatever the page zoom.

It changes only how the page is laid out on screen: the same tab, the same sign-in, the same cookies, no reload, and the site is never told the browser is a phone (no different user agent, no touch emulation). Each tab, and each session's Browser tab, keeps its own size while the app runs; nothing is saved, so a restart starts at full size.

Persistent cookies and storage

The browser uses an Electron partition called persist:browser. Everything you'd expect to survive a browser restart in normal Chrome — cookies, localStorage, IndexedDB, cached resources — survives an Omniscio restart here too, scoped to a directory inside your Omniscio user-data folder.

Practical consequence: sign into a site once and you stay signed in. Open Gmail, sign in, close Omniscio, reopen tomorrow → still signed in. This same persist:browser session is also used by the Gmail email-link viewer — the in-app page that opens when you click a link inside an email — so signing into Google in the Browser pane also lets a Google Sheet/Doc linked from an email open signed-in (and vice-versa). It is separate from the cookies the rest of Omniscio stores (the Gmail inbox itself + Google Auth Gate use their own token-based auth / partitions).

The partition is also isolated from your real Chrome profile. Omniscio has no way to import bookmarks, saved passwords, autofill, or sign-in state from external Chrome — you'll start fresh and have to sign back into each site the first time you visit.

Google sign-in caveat

Google actively detects embedded browsers (Electron webviews, Chromium Embedded Framework, etc.) and blocks sign-in on many flows with a "This browser or app may not be secure" error. Omniscio defeats this at both layers Google checks. First, a stock Chrome identity in the request: a User-Agent pinned to the browser engine Omniscio actually ships (currently Chrome 148 — a build guard fails if it ever drifts behind the engine) plus matching Sec-CH-UA Client-Hint headers for Google requests. Second — the piece that actually unblocks the sign-in — a matching JavaScript identity: Omniscio injects a real "Google Chrome" navigator.userAgentData and a populated window.chrome at page-start on Google pages, because Google's sign-in script reads those JS APIs directly and header-spoofing can't touch them. With both in place, signing into Google directly in the Browser pane works.

Caveat — this is a moving target. Google's embedded-browser detection keeps evolving and it deliberately discourages webview sign-in, so a future change on their side could re-block it. If sign-in is ever refused again:

  1. Sign in once in your real Chrome at accounts.google.com, or
  2. use the saved Browser Login fallback — with Browser Logins enabled, the Browser toolbar shows an "Open signed in" control (key icon) that reuses a login you captured in real Chrome so the pane opens already signed in, with no sign-in step for Google to block (cookies-only + best-effort — some Google surfaces may still ask you to re-log-in), or
  3. use the "Continue in your browser" hand-off the email-link viewer offers (below).

Opening a Google doc linked from an email? The Gmail email-link viewer shares this same persist:browser session, so a sign-in done in the Browser pane carries over. If Google still shows its rejection wall (accounts.google.com/v3/signin/rejected) for a private doc, the viewer detects it and replaces the dead-end loop with a one-click "Continue in your browser" button that opens the original document link in your real browser — where Google allows the sign-in — so you're never stuck.

This is a Google-side policy, and the disguise is best-effort against an evolving heuristic, which is why the email-link viewer always keeps the browser hand-off as a fallback. We don't ship cookie-import from system Chrome (security boundary) — the saved Browser Login seed is the sanctioned way to reuse a real-Chrome login in-app.

What's intentionally missing (v1)

  • No tabs. One page at a time. target="_blank" links and window.open() are blocked (popups don't open).
  • No bookmarks or history. The forward/back stack lives only as long as the pane is mounted in the current Omniscio launch; closing the pane resets it.
  • No DevTools. The webview runs sandboxed; F12 does nothing.
  • No download manager. Click-to-download will be ignored or no-op; download URLs typed directly into the address bar may navigate to a page-rendering error.
  • No file uploads via the OS picker in the v1 pass — <input type="file"> may or may not work depending on the site.
  • No extensions. Ad blockers, password managers, etc. don't apply.
  • No print / "Save page as".

These are deliberate v1 simplifications. If you find yourself needing tabs or downloads, fall back to real Chrome — the embedded browser is for casual reading and persistent-login surfaces, not as a daily driver.

In development: an opt-in AI Browser mode (Settings → Lab → ai-browser, off by default) upgrades this pane with real tabs, a bookmarks bar + manager, browsing history, a download shelf, find-in-page, and zoom + keyboard shortcuts. It is your browser: no Omniscio agent drives it (agents use their own browser, Agent Web). When that flag is off — the default — everything on this page is exactly what you get. See ai-browser.md. With both in-development flags on, a saved Browser Login can also be opened in the in-app browser, in your own per-login tab — cookies-only and best-effort; see Browser Logins.

In development: the "Open signed in" toolbar control (Pathway B, above) needs only the browser-logins flag — not ai-browser — so it works in this plain single-page pane: with Browser Logins on and a saved login captured, one click opens the pane already signed in on that login's private per-login partition (cookies-only, best-effort), with a "Signed in as <name> · Exit" indicator to return to normal browsing.

Why an embedded browser at all?

Two narrow reasons:

  1. Persistent context for Claude. A Claude session running in Omniscio might point you at a doc, a dashboard, or a sign-in URL. Opening it in-pane keeps you inside Omniscio, and the session it belongs to stays one click away in the sidebar.
  2. Login state continuity. You can sign into a service inside the Browser pane once, then visit the same URLs over and over without re-authing — useful for Google Docs you reference repeatedly, an internal admin panel, a per-team dashboard.

If you don't have either of those needs, you can simply not click the Browser sidebar entry and it stays out of your way.

The AI Browser builds on this panel for you; agents browse in their own browser through Agent Web, which can also work in your own signed-in Chrome through My Real Chrome v2.

Last verified 2026-09-23