iTerm2 Web Browser Documentation Overview iTerm2 integrates a built-in web browser that operates within the existing window > tab > split pane hierarchy, allowing simultaneous terminal and web browsing sessions. Getting Started Enabling the Browser Install the browser plugin. Create a new profile. Navigate to Settings > Profiles > General. Set Profile Type to Web Browser. Note: Enterprise admins can block the browser plugin by restricting bundle ID com.googlecode.iterm2.iTermBrowserPlugin. Disabling Browser Features Set Settings > Advanced > Enable browser-style profiles to No to completely hide browser functionality. Core Features Navigation and Window Management Browser profiles function like terminal profiles within the window/tab/pane system. Standard shortcuts, hotkey windows, and navigation shortcuts apply. Exception: ⌘-[ and ⌘-] navigate Back/Forward instead of switching panes. Link-opening shortcuts: Cmd+click → open link in new tab. Cmd+Shift+click → open in new vertical split. Cmd+Shift+Option+click → open in new horizontal split. Text and Selection Copy on selection, Smart Selection, Copy Mode, Jump to Selection, and Find behave as in terminal sessions. Find supports regex and case sensitivity. AI Integration Link browser sessions with AI chat. Use hamburger menu → Ask AI to start chat about current page. Features include summarizing, analyzing, or querying webpage content. Privacy and Security /dev/null mode: Browsing without saving data to disk. Popup blocking blocks non-user-initiated popups. Simple ad blocking using WebKit content blocker rules (configurable). CONNECT proxy support for proxy-based adblockers. Password manager integrated; browser passwords stored separately. Supports 1Password and LastPass for password autofill. Remote Access View remote files over SSH using URLs like: iterm2-ssh://example.com/home/user/file.jpg Advanced Features Bookmarks and Organization Named Marks: Bookmarks for page sections (right-click → Add Named Mark). Standard bookmarks accessible from hamburger menu. Both integrate with Open Quickly and Named Marks Toolbelt. Recording and History Instant Replay records browser sessions via macOS Screen Capture API. RAM limits apply as with terminal instant replay. Global Search can search across browser sessions. Automation and Customization Key Bindings available, excluding some terminal-specific actions. Triggers respond to page load events with web-specific actions. Pointer bindings and Actions supported, minus some terminal options. Snippets insert text into focused form fields. Broadcast Input works across browser sessions. Advanced Paste available (with some terminal restrictions). Composer feature available. Content Management Reader Mode and distraction removal (like Safari) available in hamburger menu. Right-click → Remove Element to hide unwanted page elements like cookie panels. Save web pages with resources via Shell → Save Contents. Basic autofill in forms using contact card info. Search suggestions in URL bar. Automatic audio detection and muting. Technical Details Browser built on WKWebView; identifies as Safari for compatibility. Limitations No browser-specific Python API yet. Feature requests welcome. Passkeys unsupported due to WKWebView restrictions. Advanced ad blocking limited by Apple's resource fetching API. About This Feature Designed to unify terminal and web browsing experiences. Inspired by a 2014 suggestion and personal enthusiasm. Not meant as a primary browser but as an integrated tool for terminal users. --- This documentation was created by George Nachman, Matthew Freeman, and James A. Rosen. Website optimized by HexBrain.