Mouse-Free Navigation
Mise Browser is built around a keyboard-driven workflow, enabling efficient navigation of complex web pages without reaching for a pointing device.
Link Hints Overlay (Ctrl + F)
Link Hints allow you to click any link, button, or input field on a web page using short letter combinations:
- Press Ctrl + F to trigger the hint labels.
- Mise injects two-letter tags over every clickable element on the page, using an ergonomic left-hand home-cluster layout:
q, w, e, a, s, d, z, x, c, r, f, v. - Type the two letters corresponding to your target element:
- Links navigate immediately.
- Text inputs and search bars automatically receive focus for immediate typing.
- Press Escape or press Ctrl + F again to dismiss hints without clicking.
The link hinter script is injected directly upon guest page readiness and operates independently of tab indexing, ensuring transferred, restored, and background tabs always receive link hinting capabilities. While hints are active, the status bar mode badge reflects HINTS mode live.
Ephemeral Tab Peek ("Glance")
Mise features a transient link preview modal ("Glance") inspired by the preview workflows in Zen and Arc, but engineered with zero background memory residue:
- Triggering Glance:
- Shift + Click: Hold
Shiftand click any hyperlink on a webpage to preview it immediately. - Vim Hint Sequence (
gh): Pressgfollowed byhwithin 500ms in NORMAL mode (or pressCtrl + G) to display purple link hints (#bb9af7). Typing a hint code opens the target link in the Peek preview frame.
- Shift + Click: Hold
- Transient Isolation:
- Spawns a floating modal frame over the active webview without creating a permanent tab in the tab list.
- Runs in the current workspace container partition, sharing authentication state without leaking session data.
- Instant Dismissal:
- Press Escape or click the close button to unmount the preview frame immediately.
- Invokes guest webview destruction to halt all media, abort event listeners, and detach DOM nodes completely, releasing memory back to the operating system.
- Keyboard focus returns directly to the underlying page without intermediate clicks.
- Promotion to Permanent Tab:
- Press Ctrl + Enter or click Open in Tab to convert the transient preview into a permanent tab within your active workspace.
Status Bar Address Bar (Ctrl + L / o)
Press Ctrl + L or o at any time to focus the centered address bar fixed in the bottom status bar:
- Direct Navigation: Type any full or partial URL and press Enter. Upon navigation, keyboard focus immediately returns to the guest webview so Vim normal mode shortcuts (
f,j,k,r, etc.) are active immediately without requiring a manual mouse click. - Live Search Autocomplete: As you type, Mise queries your browsing history and active bookmarks live. Use the Up and Down arrow keys to select a suggestion and press Enter. Suggestions expand smoothly upwards above the status bar.
- Direct Calculator: Type any arithmetic expression (e.g.
240 * 1.2,15% of 200,sqrt(144)) to compute the answer live in the upward dropdown menu. Press Enter to copy the answer to your clipboard, or press the Down Arrow or Tab to put the result into the address bar and continue calculating. - DuckDuckGo Bangs: Type any DuckDuckGo bang (e.g.
!w Arch Linux,!gh MiseBrowser,!yt ambient) to route directly to thousands of external search destinations. - Workspace Switching: Type
wsfollowed by a workspace name (e.g.ws work) to switch workspaces instantly from the address bar. - Terminal Execution & Oversight: Type terminal commands directly (e.g.
pacman -Syu,btop,git status) or with explicit prefixes ($,>,:sh,term). High-risk system calls (sudo,curl,wget) and script files (.sh,.py, etc.) are automatically formatted with theoversightprefix for scanning, copied safely to your clipboard, and an external terminal is spawned for deliberate pasting. - Local File Containment: Entering local file paths (starting with
/orfile://) is strictly restricted to valid PDF documents, automatically mediating them through the offline PDF viewer. Navigation to arbitrary local file paths is blocked with a status bar alert to protect system security. - Press Escape to blur the address bar, dismiss suggestions, and return focus directly to the active web page.
DuckDuckGo Bang Redirection

Mise supports over 13,500 DuckDuckGo bangs directly from the status bar address bar. Bangs route queries directly to the target website:
!w Arch Linux: Redirects directly to the Arch Linux article on Wikipedia.!gh MiseBrowser: Redirects directly to GitHub repository search.!yt lo-fi: Redirects directly to YouTube video search.!a NetworkManager: Redirects directly to the ArchWiki page.!so promises: Redirects directly to Stack Overflow.
Popular bangs display rich destination badges in the autocomplete dropdown. You can place the bang at the beginning or end of your query (e.g. !w Arch Linux or Arch Linux !w).
Custom Search Aliases & Shorthand Bangs
In addition to DuckDuckGo bangs, Mise includes native search engine prefixes that execute instantly without redirect delays. Prefix any query with an alias in the status bar address bar (Ctrl + L or o):
g <query>: Googleddg <query>: DuckDuckGoyt <query>: YouTubegh <query>: GitHuba <query>: ArchWikiaur <query>: Arch User Repositorypkg <query>: Arch Linux Packagesso <query>: Stack Overflowr <query>: Redditsp <query>: Startpageb <query>: Brave Searchk <query>: Kagi
User-Customised Search Engines
You can add your own search engines or override existing shortcuts directly in Preferences (Ctrl + H) or inside ~/.config/mise-browser/config.json:
"custom_search_aliases": {
"aur": "https://aur.archlinux.org/packages?K=%s",
"nix": "https://search.nixos.org/packages?query=%s",
"mdn": "https://developer.mozilla.org/en-US/search?q=%s"
}Any custom alias is recognised immediately in the address bar and displays an interactive suggestion badge in the autocomplete dropdown.
Live Address Bar Calculator
The address bar includes a built-in mathematical expression evaluator that runs completely locally without external network requests:
- Basic Arithmetic:
240 * 1.2,(100 + 25) / 5,150 - 45 - Powers & Roots:
2^10,sqrt(144),cbrt(27) - Percentages:
15% of 200,25% * 80 - Trigonometry & Logarithms:
sin(0),cos(pi),log2(256),log10(1000) - Constants:
pi,e
Selecting the calculator result copies the computed value to your system clipboard and displays a status bar confirmation.
Search Engine Aliases
When typing queries into the address bar, prepend shorthand prefixes to route searches directly to specific services:
| Shorthand Alias | Search Destination | Example Query |
|---|---|---|
g <query> | Google Search | g linux kernel archives |
ddg <query> | DuckDuckGo | ddg rust async tutorial |
a <query> | Arch Linux Wiki | a hyprland config |
pkg <query> | Arch Linux Package Search | pkg neovim |
gh <query> | GitHub Repository Search | gh electron |
yt <query> | YouTube Search | yt ambient coding music |
r <query> | Reddit Search | r archlinux |
so <query> | StackOverflow | so javascript closures |
sp <query> | Startpage Search | sp private search |
b <query> | Brave Search | b web standards |
k <query> | Kagi Search | k technical docs |
If no alias is entered, Mise uses your configured default search engine set in Preferences.
Auto-Collapsing Vertical Sidebar (36px Strip)
To dedicate maximum horizontal screen real estate to web content, Mise features an auto-collapsible vertical sidebar:
- Compact 36px Strip: In its default collapsed state, the sidebar shrinks to a 36px icon bar displaying only your custom workspace glyph badge (tinted in your container's custom accent colour) and crisp tab favicons. Instant peripheral visual identity ensures you always know which container is active.
- Smooth Flyout on Hover: Moving your mouse pointer over the 36px strip smoothly expands the sidebar to 260px as an overlay flyout with drop shadow. Because this expands as an overlay, the active webview never resizes, preventing GPU lag and page reflows on fanless hardware.
- Shortcut Expansion: Press Ctrl + Shift + Z to toggle sidebar expansion, or press Ctrl + S to focus the sidebar and expand it immediately for arrow-key navigation. Pressing Escape or Ctrl + W collapses the sidebar smoothly back to the 36px strip.
- Pinning: Click the pin icon button at the bottom of the sidebar, toggle Auto-Collapse Sidebar in Preferences (Ctrl + H), or run Pin / Unpin Sidebar in the Command Palette to pin the sidebar permanently open at 260px.
Sidebar and Webview Focus Management
Mise maintains clean separation between sidebar navigation and active web page interaction:
- Ctrl + S: Shifts keyboard focus to the vertical tab sidebar, smoothly expanding it. Use the Up and Down arrow keys (or
j/k) to cycle through open tabs, and press Enter to switch to the highlighted tab. - Ctrl + W: Shifts keyboard focus directly into the active webview, automatically collapsing the sidebar back to the 36px strip.
- Ctrl + X: Closes the currently active tab.
- Ctrl + R: Reloads the active tab.
Modal Navigation Engine
Mise Browser provides a Vim-inspired modal navigation engine that frees you from chorded modifiers during routine web browsing. The engine distinguishes between four primary operational states reflected in the status bar mode badge:
- NORMAL Mode: The default state. Home-row keys control page scrolling and browser actions without requiring Ctrl or Alt chords.
- INSERT Mode: Automatically entered whenever you click or focus a text input, search box, or content-editable field (or press
iexplicitly). Keystrokes pass directly into the field. Pressing Escape blurs the field and immediately returns to NORMAL mode. - PASSTHROUGH Mode: Designed for rich web applications like Google Docs, sheets, design suites, and cloud terminals. In passthrough mode, all keystrokes pass directly to the guest web application without browser interception. Toggle passthrough mode at any time using Shift + Escape or by clicking the mode badge in the status bar.
- HINTS Mode: Automatically active while link hints are displayed over the page (
Ctrl + Forfin NORMAL mode). The status bar indicator synchronises live via guest DOM mutation monitoring, returning to NORMAL mode upon hint selection or dismissal.
NORMAL Mode Keymap
| Key | Action | Description |
|---|---|---|
j | Scroll Down | Scroll down by 80px |
k | Scroll Up | Scroll up by 80px |
d | Dark Reader | Toggles high-contrast dark theme on active tab |
u | Half Page Up | Scroll up by half the viewport height |
h | Scroll Left | Scroll left by 80px |
l | Scroll Right | Scroll right by 80px |
gg | Jump to Top | Jump to top of page |
G | Jump to Bottom | Jump to bottom of page |
t | New Tab | Opens a new tab with default search engine |
x | Close Tab | Closes the current active tab |
o | Address Bar | Focuses centered status bar address bar |
r | Reload | Reloads active tab |
R | Force Reload | Reloads active tab ignoring cache |
H | History Back | Navigates back in page history |
L | History Forward | Navigates forward in page history |
/ | Find in Page | Opens the in-page search bar |
n | Find Next Match | Jumps to next search match in page |
N | Find Previous Match | Jumps to previous search match in page |
f | Link Hints | Injects two-letter hint tags over clickable links |
e | Reader View | Toggles native distraction-free reader view |
m | Mute Tab | Mutes or unmutes audio output on active tab |
M | Global Mute | Mutes or unmutes audio across all tabs |
p | Pin Tab | Toggles pinned status on active tab |
w | Dashboard | Opens the Workspace Dashboard tree |
s | Focus Sidebar | Moves focus to vertical sidebar tab list |
y | Yank URL | Copies current URL to clipboard with status bar feedback |
i | Insert Mode | Explicitly enters INSERT mode |
Shift + Escape | Passthrough Mode | Toggles PASSTHROUGH mode on or off |
Pinned Tabs & Accidental Closure Guard
Keep vital dashboards, communications, and media tabs protected from accidental closure and easily accessible:
- Instant Pinning: Press F4 (or press p in NORMAL mode, or click the pin icon in the tab item) to pin or unpin any tab.
- Top-Anchored Priority: Pinned tabs are neatly grouped and anchored at the very top of the active workspace tab list, marked with a distinctive golden pin dot badge.
- Accidental Closure Guard: If you press Ctrl + X while viewing a pinned tab, Mise blocks closure and displays a status bar warning reminding you that the tab is pinned. This prevents losing ongoing research, active streams, or draft forms.
- Persistent Pinning: Pinned tab states persist in
~/.config/mise-browser/session.jsonacross reboots and window reloads.
Workspace Badges, Tab Jumping & Favicons
- Direct Tab Jumping: Focus the sidebar (Ctrl + Tab or s) and press 1 through 9 to jump directly to any numbered tab without waking intermediate tabs into memory.
- Dynamic Tab Number Badges: Small index badges (
1to9) appear over tab favicons whenever the sidebar has keyboard focus or theCtrlkey is held, showing the exact number to jump to. - Non-Disruptive Sidebar Cursor Navigation: Moving with j / k or Down / Up moves the cursor highlight across tabs without waking sleeping tabs into memory. Press Enter, Space, or l / Right to activate the highlighted tab.
- Workspace Badges: The top of the strip displays a compact letter or number badge for the current workspace (such as
W1orP). Clicking the workspace badge opens the Workspace Dashboard (Ctrl + Shift + W). - Favicons & Indicators: Each tab renders its website favicon with smart local and remote caching. Sleeping tabs display a subtle moon indicator, while tabs playing audio render a green audio badge.
Dual Split View (1x2 Side by Side and Stacked)
For comparing documentation, pull requests, or research sources without tiling window manager complexity, Mise includes a built-in dual split view:
- Instant Comparison: Press Ctrl + Shift + S (or click the column icon in the sidebar) to split the viewport into two 50% columns side by side.
- Orientation Toggle: Right-click the split icon button or execute Cycle Split View Orientation in the Command Palette to switch between side by side (vertical columns) and stacked (horizontal rows).
- Focus Switching: Press Ctrl + O to switch keyboard focus between Pane 1 and Pane 2. The active pane displays an accent focus ring, and its matching sidebar tab is highlighted with a numbered badge (1 or 2).
- Pane Swapping: Press *Ctrl + * to swap the positions of the two open split panes instantly.
- Context Menu Link Routing: Right-click any hyperlink on a page and select Open Link in Split View to open or send that link directly into the adjacent comparison pane.
- Tab Assignment: Clicking any tab in the sidebar while in split mode routes that page into whichever pane currently holds active focus.
- Hibernation Exemption: Both visible split panes are automatically protected from background tab sleep while displayed on screen.
Native Reader View (F9 / e)
Mise includes an in-engine DOM distiller powered by Mozilla Readability to strip ads, sidebars, cookie banners, and visual clutter from articles:
- Instant Distillation: Press F9 or press e in NORMAL mode to extract the core article, byline, and imagery into a clean reading format.
- Isolated Shadow DOM: The reader view is rendered inside an isolated Shadow DOM container over the active document. Closing Reader View (via Escape, F9, or the close icon) restores the original web page instantly without reloading or discarding form inputs.
- Custom Typography and Themes: A floating controls pill at the top-right corner allows adjusting:
- Themes: Dark (Tokyo Night), Sepia (Warm Paper), and Light.
- Font Families: Modern Sans-serif, Classic Serif, or Clean Monospace.
- Font Size: Adjustable scale between 14px and 28px.
- Reading Width: Narrow (620px), Medium (760px), or Wide (940px).
- Reading Metrics: Header estimates word count and reading time based on typical reading velocity.
Native Downloads Shelf (Ctrl + Shift + D)
Manage ongoing and completed file downloads directly within the application without leaving your active tab:
- Download Shelf Toggle: Press Ctrl + Shift + D to display or hide the bottom downloads drawer.
- Live Progress & Speed: Displays active transfers, download velocity, percentage completion, and elapsed time with visual progress indicators.
- Tracked Path Containment: Opening or revealing downloads via IPC handlers (
open-download,reveal-download) is strictly restricted to canonical realpaths of tracked active and recent downloads. Untracked or arbitrary renderer-supplied paths are rejected. - Dangerous Extension Safeguards: Downloaded files matching dangerous executable or script extensions (
.exe,.msi,.bat,.cmd,.com,.scr,.ps1,.vbs,.js,.jse,.wsf,.lnk,.jar,.sh,.run,.appimage,.desktop,.command,.app,.dmg,.pkg,.deb,.rpm) are identified case-insensitively. Opening a dangerous file automatically diverts from direct execution to revealing the file safely inside the system file manager. - Non-Blocking File Manager Integration: File manager discovery and revelation utilise asynchronous, non-blocking execution with timeouts over D-Bus (
org.freedesktop.FileManager1) and XDG desktop configurations, ensuring the browser UI never freezes during disk or process operations.
In-Page Search & Match Navigation (Ctrl + Shift + F / F3 / /)
Find text across active web content with instant matching and Vim-style navigation:
- Instant Search Activation: Press Ctrl + Shift + F, F3, or press / in NORMAL mode to display the floating Tokyo Night search bar (
#FindBarOverlay). - Live Match Counter: Displays real-time match statistics as you type (such as
4 of 21 matches,1 of 1 match, or0 matcheswith high-contrast alert styling when no matches are found). Chromium natively highlights all match positions along the vertical scrollbar track. - Automatic Vim SmartCase: Adopts standard Vim search behaviour. Searching with an all-lowercase query performs case-insensitive matching; typing any uppercase character automatically engages case-sensitive matching.
- Case Sensitivity Toggle (
Aa): Click theAabutton or navigate to it via keyboard to manually toggle case matching, with an illuminated accent border reflecting active status. - Fluid Keyboard Navigation & Focus Handoff:
- Type a search query and press Enter to confirm. Keyboard focus immediately returns to the active webview, enabling single-key cycling with n (next match) and N (previous match) in NORMAL mode without touching the mouse.
- Use Tab to cycle keyboard focus through overlay controls within a circular trap: Search Input -> Case Toggle (
Aa) -> Previous Match (Chevron Up) -> Next Match (Chevron Down) -> Close (X) -> back to Search Input. - Pressing Enter or Space while focused on any navigation button triggers the action and returns focus directly to the webview.
- Pressing n or N while focused on overlay buttons drops focus back to the webview and jumps to the next or previous match.
- Press Escape from the search input, overlay buttons, or the webview to dismiss the search bar and clear highlight markers.
