Muxie Get Muxie
How-to guides How-to guide

Use a browser pane

Preview a web app inside Muxie, choose a search engine, handle HTTP auth, and enable agent-driven browsing.

A browser pane lets you preview a web app right next to your terminal, without switching windows.

Open a browser pane

Open the + New menu and choose Browser. The pane has an address bar, back and forward buttons, and reload.

Choose a search engine

The searchEngine setting sets the default search engine for the address bar:

  • duckduckgo
  • google
  • bing
  • bing-ai
  • perplexity

Handle HTTP auth

When a site responds with HTTP basic auth (a 401 or 407), Muxie shows an in-pane credential banner. Enter your username and password there to continue.

Open DevTools

Toggle DevTools for the browser pane with:

  • Ctrl+Shift+I on Linux and Windows
  • Cmd+Alt+I on macOS

Let an agent drive the pane

For agent-driven browsing, turn on the browserAutomationEnabled setting. It opens a loopback CDP (Chrome DevTools Protocol) debug port so an agent can control the pane.

Heads up: The debug port is loopback-only, so it isn’t reachable from other machines.

From the CLI:

  • muxie browser automate — returns a CDP endpoint an agent can connect to.
  • muxie browser navigate|reload|back|forward — control a browser pane directly.

See the CLI reference for details.

Tip: Pair a browser pane with port forwarding to preview a service running on a remote host or sprite.