Octoweb 0.22: link routing, history import, agent pause

· · 8 min read

Octoweb 0.22.0 is out. A link you click in another app now opens in the workspace you chose for its site. You can bring in your history from Arc, Chrome, Brave, Edge, Vivaldi, Firefox or Safari, so the command palette knows your sites on the first day. The address bar shows when an AI agent is working in your tabs, and one click pauses it. Mail's composer now formats text, and the first click on the sidebar or a page no longer goes missing.

If you're on 0.19 or later, Octoweb installs this update the next time you quit. To get it now, choose Check for Updates… in the Octoweb menu. Update octomind as well:

brew upgrade octomind

Links from other apps open in the workspace you chose

A workspace in Octoweb is a separate profile, with its own tabs, cookies and sign-ins. Until now, a link you clicked in Slack, Mail or a terminal opened in whichever workspace was on screen. A work link could land in your personal workspace, where you aren't signed in to it.

Now each workspace can list its sites. Open Settings (⌘,) → General → Links from other apps. There is one box per workspace. Put one site on each line, as a domain or a full URL:

github.com
linear.app

When another app opens a link to one of those sites, Octoweb switches to that workspace and opens the link in a new tab there. A site covers its subdomains, so github.com also catches gist.github.com, and a leading www. makes no difference. Links to sites you haven't listed open in the workspace you're in, as before. If two workspaces list the same site, the one higher in the workspace list gets the link.

This applies to links that come from outside Octoweb, including the one that launches it. Links you click inside a page stay in their workspace. The boxes appear once you have a second workspace.

Import history from another browser

The command palette (⌘⇧P) finds a page from a fragment of its title or address, and ranks the pages you visit often higher. In a browser you just installed, it has nothing to find. Settings → General → Import fixes that: pick a browser under History from another browser and click Import.

Octoweb lists Arc, Chrome, Brave, Edge, Vivaldi and Firefox when it finds their history on your Mac, and always lists Safari. It reads the most recently visited web pages, with their titles, visit counts and last-visit times, and adds them in the room left under your Max history setting (1000 unless you changed it). Your own history is never pushed out to make room, and a page that's already in it keeps the record Octoweb made. When the import is done, the row says how many pages came in, such as "Added 812 pages to your history."

Three things to know:

  • The other browser is left alone. Octoweb copies its history file and reads the copy. Nothing is written to the original, and the other browser can stay open while you import.
  • Safari needs your permission. macOS keeps Safari's history from other apps. Allow Octoweb in System Settings → Privacy & Security → Full Disk Access, then import again. The row tells you this when macOS refuses.
  • History only. Bookmarks, passwords, cookies and open tabs are not imported. If the browser has several profiles, Octoweb reads the one you used last.

See when an agent is in your tabs, and pause it

An agent here means the sidebar assistant, or any outside AI tool connected to Octoweb's MCP server, the local server that lets AI tools drive the browser. Agents open and work in background tabs, so they don't take over the page you're reading. That also meant you couldn't tell they were there.

Now, while an agent works, a chip appears in the address bar: Agent in 2 tabs, with a pulsing dot. It stays until two minutes after the agent's last action in a tab. In the command palette, those tabs carry an Agent pill, so you can switch to one and look.

Click the chip to pause. It turns into Agents paused, and from then on every tool call an agent makes is refused: opening pages, clicking, typing and reading, and the mail, calendar and tasks tools too. The refusal tells the agent that you paused it, that it shouldn't retry, and that the chip resumes it, so it can tell you instead of trying again. Click the chip once more to let agents continue.

What How the pause treats it
A tool call already running Finishes. The next one is refused
The sidebar chat Still answers, but can't use its tools until you resume
Several agents at once All paused together. There is no pause for one agent
Quitting and reopening Octoweb Clears the pause. Octoweb starts with agents allowed

Mail: format what you write

The body of a message used to be a plain text box that understood a little Markdown, such as **bold** and - lists. It's now a rich-text editor with a format bar:

Control Shortcut
Bold ⌘B
Italic ⌘I
Underline ⌘U
Strikethrough ⇧⌘X
Link ⌘K
Bulleted list ⇧⌘8
Numbered list ⇧⌘7
Quote ⇧⌘9
Clear formatting ⌘\

The message goes out as HTML with a plain-text version beside it, for mail apps that show only text. Text you paste keeps its bold, italic, underline, strikethrough, lists, quotes and links. Colors, fonts and images in it are dropped. Drafts keep their formatting, including the ones the AI writes for you.

The composer doesn't offer fonts, sizes, colors, headings or tables, and it doesn't place images inside the text: attach them instead. Your signature stays plain text.

The assistant

  • The default agent is now octoweb:chief. It replaces octoweb:assistant. Your saved chats move to the new name when they load, and the old name still works if you type it. The picker for a new chat lists domains first, such as developer. Picking one starts that domain's lead agent, which hands the work to the right specialist.
  • Cards follow A2UI 1.0. The cards the assistant draws in the sidebar, with forms and buttons, now follow version 1.0 of the A2UI specification. If you write your own agents: a card in the older format is refused, with an error for each thing that's wrong with it. A button whose checks fail is switched off and shows the reason when you point at it.

Smaller changes

  • The first click counts. When another part of the window had the keyboard, the first click on the sidebar, a page, the address bar or the quick-slot bar only moved the focus there, and it took a second click to press the button. The first click now does the job.
  • Terminal text comes back whole. After the Mac slept, or the terminal panel had been hidden for a while, some characters could be missing from the terminal. Octoweb now redraws them when the window gets the focus.
  • A shorter agent list. Old agent names that are kept only so they still work no longer show up in the new-chat picker.
  • Search operators reach your search engine. A query such as site:github.com rust in the address bar now goes to your search engine. Before, Octoweb read site: as a link to another app and handed it to macOS, so nothing opened. An operator with no words after it, such as site:github.com alone, is still read as an app link.
  • No old page when you go back to a tab. While a sleeping tab reloads, Octoweb shows a picture of it saved when you left. If the tab had moved to another page since then, you could see the old page under the new address. The picture is now shown only when it matches the tab's page.
  • No blank window while an agent works. Switching away from a tab an agent was working in could leave the window empty until the next tab started to load. The old page now stays on screen until the new one replaces it.

Upgrade

Octoweb updates itself on quit, or now with Check for Updates… in the Octoweb menu. You can also run brew upgrade --cask octoweb, download the DMG, or get it from the 0.22.0 release. Update octomind as well with brew upgrade octomind. The complete commit list is in the changelog. For the keyboard, see the shortcut reference, or press ⌘/ in Octoweb for the live list.

Don Karter

Don Karter

CEO & Co-founder at Muvon

20+ years in software engineering, the last decade deep in AI systems. Builds Octoweb — a keyboard-first AI browser for macOS on WebKit and Rust. Writes from the trenches: native browser engineering, agents driving real pages over MCP, and what breaks when every action has to be one keystroke away.

Octoweb is free and open source, for macOS.

Install it →