Octoweb — the keyboard-first AI browser for macOS
The browser you reach for when you want to think. macOS only, by design.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Built on WebKit and Rust. No Electron. No Chrome. No mouse required.
Most browsers are built around the mouse. Octoweb is built around the keyboard — and around the idea that your browser should amplify your thinking, not interrupt it. Every action has a shortcut. The AI assistant lives in a sidebar, not a tab. And your AI tools can drive the browser directly via MCP. No config. Just open it and go.
Three things it does differently:
Keyboard-first navigation — Every action has a shortcut. Nothing requires a click. The command palette (⌘⇧P) fuzzy-searches tabs and history. Pin any page to a fast-access slot with ⌘⇧1–⌘⇧0 and jump back with ⌘1–⌘9 from anywhere.
AI assistant built in — Not an extension, not a tab. A sidebar overlay powered by a local octomind agent server. Ask questions about the current page, get code explanations, summarize content — all without leaving the browser.
MCP server inside the browser — Your AI tools can actually drive the browser. Octoweb runs an MCP server on localhost:3434/mcp that exposes 38 tools for navigation, tab management, page interaction, content extraction, and mail. Point Claude Desktop or any MCP client at it and watch it browse.
⌘⇧P) — Fuzzy search across tabs and history. Type a URL, search query, or page fragment./ in the palette) — Search the text of pages you have visited, not just titles. "Where did I see that pricing table" is one keystroke away; the agent gets the same search as an MCP tool. Private tabs are never indexed.⌘⇧C) — Copies the URL, or the selection with the URL under it, as plain text. ⌥⌘C copies markdown instead: a quote with its source link, or the whole page as clean markdown when nothing is selected. ⌥-click the address bar's copy button for a [title](url) link.⌘⇧L) — A reading queue that decays instead of a bookmark shelf: saved pages sit on top of the palette and the new-tab page, opening one removes it, and after later_days they drop out while their text stays searchable. The digest-later workflow turns whatever you never opened into three lines each.⌘⇧K) — Select text on any page and ask the sidebar to explain it, with the page as context. No selection asks about the page.⌘⇧↵ in the palette) — Open any result in an isolated tab with in-memory cookies and storage. Nothing is written to history, the session file, or the favicon cache; closing the tab discards everything.⌘1–⌘0) — Pin up to 10 pages for instant access, one set per workspace. Footer bar shows all slots.⌘⇧N) — Pin the current tab to the fast-access bar with one keystroke.⌘⇧O) — Isolated browser profiles: each workspace has its own tabs, history, AI sessions, and a dedicated WebKit data store, so cookies, localStorage, and cache never leak between them. Switch with ⌘1–⌘0 while the popover is open.⌘,). Changes apply on the next keystroke, no restart.⌘⇧A) — Chat with a local AI agent about the current page. Streaming responses, code blocks with copy.⌘⇧E) — Select text on any page, transform it with AI. Rewrite, summarize, translate.⌘,).⌘⇧I) — Gmail, iCloud, Outlook, Private Email, or any IMAP account in a pane beside the page: Important and Other, single-key triage, snooze, undo send, send later, search, attachment previews. Accounts are scoped per workspace.⌘⇧D) — The calendars of those same accounts (Google Calendar, Outlook, iCloud, CalDAV) in the pane: the next meeting with a Join button, an alert before it starts, ⌘J to join from anywhere, list/day/week views, RSVP, quick add in plain English ("Lunch with [email protected] tomorrow 1pm"), and your free times copied as text. Subscribe to webcal:// / ICS feeds, import .ics files (drop them on the pane), and answer invitations right in the mail message. With mail AI on: an event drafted from an email, free times offered in a reply, meeting prep from the guests' mail and last notes, and tasks or a follow-up from the meeting's notes.⌘⇧J) — One markdown file per workspace. ⌥⌘J captures the page as a task, or the selection as a quote.⌥⌘T) — The open - [ ] lines of the notes, above the text in a block you can fold: an add field, then Overdue, Today, Upcoming and the ones without a date. >fri in a task becomes an Obsidian Tasks date (📅 2026-10-30); due tasks show in the calendar and as a count on the Notes tab.⌘`) — A real shell under the page, with tabs and splits, per workspace; layout, directories, and output come back after a restart..crx, .zip, .xpi, or unpacked folder, scoped per workspace (macOS 15.4+).⌘F) — Full-text search with highlighting.+/- to zoom, ⌘0 to reset.⌘S for viewport, ⌘⇧S for full page. Copied to clipboard.Press ⌘⇧A to open the sidebar. It talks to a local octomind agent server over WebSocket. Responses stream in as they arrive.
octoweb ──WebSocket (loopback, per-run token)──▶ octomind server
│ one session per chat / background job │
│ (own working dir + agent tag each) specialist agent configs
│ from the tap registry
◀───────── MCP (browser tools, render_ui) ──────────────┤
your chosen AI provider
Octoweb starts ONE octomind server process the first time an assistant is needed and runs every assistant in it —
every chat in every workspace, inline edit, background learning and the mail jobs — each as its own session with its
own working directory and agent tag. The server is stopped when octoweb quits.
octomind is a plug-and-play AI agent runtime. You install it once, point it at an API key, and get a fully configured specialist agent — model, system prompt, tools, and all — with zero manual setup. The octoweb:assistant tag fetches that agent's configuration from the community tap registry automatically.
1. Install octomind:
curl -fsSL https://raw.githubusercontent.com/muvon/octomind/master/install.sh | bash
2. Set an API key (any supported provider):
export OPENROUTER_API_KEY="your_key" # easiest — covers all providers
# or: OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.
3. Nothing else to start — octoweb launches octomind server itself (on a free loopback port, with a per-run
secret), resolves the octoweb:assistant agent from the tap, and connects every sidebar session to it.
4. Open the sidebar in octoweb: ⌘⇧A
The agent tag in the sidebar header defaults to octoweb:assistant. You can type any tag your octomind instance knows about — developer:rust, assistant, your own custom agents — the new-session picker autocompletes as you type, and the sidebar reconnects to that agent immediately.
Shipped tags include octoweb:assistant (sidebar chat), octoweb:editor (inline text transformation, used by ⌘⇧E), octoweb:learning (background learning), and octoweb:trend (live social trend research) — see the tap registry.
The octoweb:assistant agent uses a stable working directory per browser workspace.
Default keeps ~/.local/share/octoweb; other workspaces use
~/.local/share/octoweb-workspaces/octoweb-<workspace-id>. Renaming a workspace
keeps its directory and Octomind lesson scope. Each directory has the same local
tools and links to Default's .env and AGENTS.md when present; existing
workspace-specific files are kept. Existing lessons stay in Default's scope.
Other agent roles continue using the shared directory.
No data leaves your machine unless your agent sends it somewhere. The AI provider call is made by octomind, not by the browser.
Agents can do more than reply with text: via the render_ui tool they can draw interactive surfaces — forms, buttons, live views — inline in the sidebar chat. Buttons can open URLs in a new tab or resolve back to the agent.
Octoweb speaks A2UI v1.0 and renders the full basic catalog (Card, Row/Column/List, Text, Image, Icon, Video, AudioPlayer, Button, TextField, CheckBox, ChoicePicker, Slider, DateTimeInput, Tabs, Modal, Divider), including data-model binding, ${…} string interpolation, list templates, validation checks, accessibility attributes, and agent-issued callRendererFunction. Envelopes are validated before they render, so a malformed surface comes back to the agent as a precise error instead of a blank card.
Octoweb runs a background agent that periodically analyzes your browsing patterns and memorizes insights. It is off by default — it reads your open tabs, history and the active page's text, which is a thing to opt into rather than discover. Turn it on in Settings (⌘,).
How it works:
learning_interval_min (default: 30), the background agent wakes upremember to check existing memories, then memorize for new insightsConfiguration:
proactive_learning = false # enable background learning (default: off)
learning_interval_min = 30 # minutes between runs (floored to 5 on load)
The learning agent runs as its own octoweb:learning session on the shared octomind server. It's completely independent from the sidebar assistant — you can use one without the other.
octoweb runs an MCP server on localhost:3434/mcp. Any MCP-compatible AI client — Claude Desktop, octomind itself, your own scripts — can use it to control the browser directly.
Claude Desktop / octomind / any MCP client
│
│ HTTP JSON-RPC
▼
localhost:3434/mcp (inside octoweb)
│
▼
WebKit WebView — navigate, click, type, read, run JS
Available tools:
Workspace routing: one server serves every workspace. A request's X-Octoweb-Workspace token says which workspace it acts on; callers that send no token fall through to the first workspace. The sidebar's agent sessions carry their token automatically, so an agent driving tabs in a background workspace never disturbs the one you're looking at.
Point Claude Desktop at http://localhost:3434/mcp and it can browse, read, fill forms, and navigate — all while you watch.
Safety. The endpoint validates the Origin header, so a page you happen to be visiting cannot fetch() it and drive your logged-in browser; command-line clients, which send no Origin, are unaffected. Read tools carry readOnlyHint so a host can auto-approve them instead of prompting on every page read. Everything a page authored — browser_get_page_content, browser_snapshot, browser_console_messages, browser_network_requests — comes back inside an <untrusted> fence, because an agent that can click and type should know which bytes are the page's. Set OCTOWEB_MCP_PORT / OCTOWEB_CONFIG_DIR to run an isolated second instance (e.g. for the e2e suite: python3 test_mcp.py --mcp-url http://127.0.0.1:3435/mcp).
Because octomind has a built-in mcp tool that can register external servers at runtime, you can give any running octomind agent live browser access in one step:
# inside an octomind session
/mcp add octoweb http://localhost:3434/mcp
The agent can now navigate pages, extract content, and interact with the browser as part of its normal tool use — no restart, no config change.
Every shortcut is configurable in Settings (⌘,) — remaps persist to ~/.config/octoweb/keybindings.json and apply on the very next keystroke, no restart. The ⌘+digit slot keys are positional and not remappable.
Pin any page to a numbered slot and jump back to it instantly — one keystroke from anywhere. Slots are shown in a footer bar at the bottom of the window and on the new-tab page.
⌘⇧1–⌘⇧9 / ⌘⇧0 — save the current page to slot 1–9 / 10⌘1–⌘9 — navigate to the saved URL in that slotSlots persist across restarts and are scoped per workspace — pinning in one workspace never touches another's. An empty slot does nothing.
⌘0 defaults to zoom reset and wins over slot 10 — rebind zoom reset in Settings if you want ⌘0 to open slot 10. ⌘⇧0 still saves to slot 10.
⌘⇧O)The switcher popover lists every workspace with its tab count; the one you are in is highlighted.
⌘⇧M opens the same popover to pick a destination for the current tab. Selecting one moves the tab there and reloads it — workspaces have separate cookie and storage stores, so nothing of the live page carries across. If it was the workspace's last tab, a fresh one takes its place.
⌘⇧F)Reaching content inside a page without a mouse. Press ⌘⇧F and every clickable thing in the viewport — links, buttons, form fields, ARIA controls — gets a short home-row label. Type the label to activate it.
Labels are one character for up to 9 targets and two beyond that. Only what is on screen is labelled — scroll and press again. Elements hidden behind a modal or cookie banner are skipped, since a click would not reach them either. Same-origin iframes are included; cross-origin ones cannot be reached.
⌘⇧P)The main interface. Type a URL, a search query, or any fragment of a page title or URL you've visited — it fuzzy-matches across open tabs and history instantly, ranked by match quality and visit frequency.
When a query is entered, three action rows appear at the bottom: Search Google, Open URL, and Ask AI. Select one and press Enter, or use the dedicated shortcuts below.
⌘⇧↵ opens whatever is selected — an open tab, a history entry, a typed URL, or a search — in a private tab. It gets its own in-memory WebKit data store, so cookies, localStorage, and cache are separate from the workspace and vanish when the tab closes. Private tabs never write to history, the session file, the favicon cache, or the ⌘⇧T reopen list, and popups they open stay private. They show a Private pill in the palette and are not restored on restart.
Pages saved with ⌘⇧L show first, with a Later pill, when the query is empty; opening one removes it from the queue. Start the query with / to search page text instead of titles and URLs: every word must match as a prefix, results are most recent first, and each shows the passage that matched. The index keeps the first few kilobytes of text of the last 2000 pages in page_index.json. Open tabs also show their WebContent memory in megabytes next to the pill, so the tab eating your RAM is one glance away.
⌘⇧A)The sidebar overlays the page on the right — the page content underneath is not resized.
Prompt history:
Ctrl+P / Ctrl+N — Navigate older/newer prompts (MRU order)Ctrl+R — Reverse incremental search through historyCtrl+E — Accept ghost text autocompleteCtrl+U — Clear input to cursor startHistory persists across sessions (ai_prompt_history.json).
Repeatable tasks. The bundled tap ships browser workflows — watch a page for changes, compare open tabs, cancel a subscription, fill a form from memory, summarize a thread, digest what you saved for later. Type /workflow and pick one from the dropdown, then give it its input. The assistant can launch them itself through the tap tool, so a recurring job is /schedule add when=... every=... message="<workflow and input in plain words>": when the message fires, the assistant runs the workflow in the background and relays its result. Pending routines show as a ⏱ chip in the header (click it to list them). Routines fire only while Octoweb is running, since the assistant session is the scheduler.
⌘⇧E)Select text on any page and press ⌘⇧E to open the inline edit modal. The AI can rewrite, summarize, translate, or transform the selected text.
Prompt history works the same as the sidebar (Ctrl+P/N/R/E/U).
⌘F)Full-text search with highlighting. Uses CSS Custom Highlight API for fast, native rendering.
Homebrew (recommended):
brew install --cask muvon/tap/octoweb
Direct download: the notarized DMG for Apple Silicon from octoweb.xyz/download. Open it and drag Octoweb.app into /Applications.
Updates: Octoweb checks for a new version once a day, downloads it in the background and installs it when you quit. Turn either off in Settings → General → Updates. The Homebrew cask installs the same DMG, so it updates the same way. Details: docs/auto-updates.md.
Build from source (requires Rust toolchain and Xcode Command Line Tools):
git clone https://github.com/muvon/octoweb
cd octoweb
# Dev build (ad-hoc signed, no cert needed)
./build.sh --dev
# Release build (requires Developer ID cert)
./build.sh
# Publish a release as a Sparkle update (owner only, see docs/auto-updates.md)
./release.sh
# Run
open dist/Octoweb.app
Or install to Applications:
cp -r dist/Octoweb.app /Applications/
Config lives at ~/Library/Application Support/octoweb/config.toml. Created on first launch with defaults.
Open Settings with ⌘, to configure visually, or edit the file directly:
home_page = "https://www.google.com"
search_engine = "https://www.google.com/search?q={}"
max_history = 1000
window_width = 1280
window_height = 800
ai_edit_auto_hide = false # auto-hide inline edit after submit
max_prompt_history = 50 # editor prompt history size
max_ai_prompt_history = 50 # sidebar prompt history size
max_acp_session_messages = 500 # chat messages retained per AI session (FIFO)
proactive_learning = false # enable background learning agent (default: off)
learning_interval_min = 30 # minutes between learning runs (floored to 5 on load)
aggressive_hibernation = false # aggressive tab-hibernation curve for tight-RAM machines
max_tabs = 500 # max open tabs (0 = no limit)
later_days = 14 # days a "save for later" page stays queued (0 = forever)
Persistence:
max_history entriesoctoweb is an experiment. It's a real, usable browser — WebKit rendering, proper tab management, session restore, back/forward gestures, progress bar, error pages — but it's also a playground for the idea that a browser can be a first-class AI client, not just a container for AI extensions.
It's macOS only. It will stay that way for now — the whole thing leans on macOS-native APIs (CGEventTap for global hotkeys, WKWebView via wry, AppKit for the dock icon and menus).
It won't replace your main browser. It might become the browser you reach for when you want to think.
codegen-units=1 + stripped binaryKeyboard-first AI browser for macOS — WebKit + Rust, built-in AI sidebar, isolated workspaces, and an MCP server that lets your agents drive the web.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Octoweb läuft lokal über stdio.
Zuletzt geprüft: 2026-11-16. Keyboard-first AI browser for macOS — WebKit + Rust, built-in AI sidebar, isolated workspaces, and an MCP server that lets your agents drive the web.