GitHub

Browser

Every task gets its own browser tabs. The dev server for this branch, the PR the agent just opened, the API docs you keep checking: they sit in the task’s layout next to its code and terminals, and they stay with that task when you switch to another. Come back and they reopen on the pages they were showing.

Press Command+Shift+B to open a browser panel. Like any panel, it can go next to an agent’s terminal, under your editor, or in a group of its own (see Panel Layout). From a terminal, loxel <url> opens a page in the task that terminal belongs to, and an agent with the loxel skill does the same to show you what it started.


Browsing

A browser panel is a full web view with back, forward, reload, an address bar, and DevTools. A new blank panel starts with the cursor in the address bar, so you can type a URL or a search right away. Command+F finds text in the page, and Command+Shift+R while the tab has focus does a hard refresh, reloading the page and bypassing the cache. Clicking the title of the active browser tab returns focus to its page.

Pages see the light or dark mode you choose in Settings > Appearance > Theme, not your Mac’s: a site or dev server that follows the system appearance (prefers-color-scheme) shows its light colors in a light Loxel and its dark colors in a dark one. With System, they follow your Mac as Loxel does.


Bookmarks

Bookmark a page with the star at the end of the address bar, or Command+D while the tab has focus; the star fills in on a bookmarked page, and clicking it again removes the bookmark. The bookmark button next to the address bar lists your bookmarks, and a new blank tab shows them in place of an empty page. Click one to open it in the current tab, or Cmd-click or middle-click it to open it in a background tab (Command+Shift-click switches to it). Hover a bookmark and click its ×, or press Delete on it in the list, to remove it. Bookmarks are shared by all your projects and windows and kept across restarts.


A plain click on a link opens it in the same tab. Links you open in a new tab or window become browser tabs right after the current one, in the same group:

  • Cmd-click or middle-click opens the link in a background tab and keeps you on the current page, so you can hold Cmd and click several links in a row. The new tabs keep the order you clicked them in.
  • Command+Shift-click opens the link in a new tab and switches to it.
  • Links that open a new window (target="_blank", or a page opening a window when you click something) open in a new tab and switch to it.
  • Popup windows a page opens at a set size, such as a “Sign in with Google” window, open as a separate small window over Loxel, so the sign-in can finish and return to the page. The window’s title shows the site it belongs to, and Command+W closes it.

Windows a page tries to open without you clicking or typing are blocked, and each click opens at most one tab or popup.

Cmd-clicking a URL in terminal output opens it in a browser panel too; a plain click opens it in your default browser.


Right-click menu

Right-click in a page for a menu that matches what you clicked:

  • Link — open it in a new tab (next to the current one, in the background), open it in your default browser, or copy its address.
  • Image — open it in a new tab, save it, copy it, or copy its address.
  • Selected text — copy it or search the web for it. In a text field you can also cut, paste and select all.
  • Page — back, forward, reload, or view the page source in a new tab.

Every menu ends with Inspect Element, which opens DevTools on the element you clicked.


Logins and passkeys

All browser panels share one persistent session, so cookies and logins carry across panels, tasks and restarts: sign in to GitHub once and every task’s tabs are signed in. In the signed macOS app, sites can create and use passkeys with Touch ID.

You can also sign in with a passkey saved on your phone. When a site asks for a passkey your phone can provide, the browser panel that asked shows a QR code: scan it with your phone’s camera and confirm on the phone. Bluetooth has to be on for both your Mac and your phone, because the phone checks that it is nearby, and the first time macOS asks to let Loxel use Bluetooth. Hide QR code only hides the code: the site still waits, so you can answer with Touch ID or a security key instead. When a site asks for a passkey that only a single device holds, such as one kept in this Mac’s iCloud Keychain, no code appears and the site’s other sign-in options still work.


Page dialogs

When a page calls alert(), confirm(), or prompt(), the dialog opens over that page and names the site that asked. Only that browser panel waits for your answer; the rest of Loxel stays usable. Return confirms and Escape cancels. Starting from a page’s second dialog, you can check Don’t allow this page to show more dialogs to silence it until it reloads or navigates. Reloading or navigating also dismisses any dialog that is open.


See also

  • Panel Layout — splitting, moving and maximizing browser panels like any other
  • Loxel CLI — which task and window a loxel <url> page opens in
  • Keyboard Shortcuts — browser shortcuts alongside the rest