Documentation
BrowserShell turns your browser into a scriptable environment.
Start here
| Guide | Description |
|---|---|
| Getting started | Install and run your first commands |
| Core concepts | Overlay, commands, VFS, clickable lists |
| Demo walkthroughs | Step-by-step workflow explanations |
Guides
| Guide | Description |
|---|---|
| Superuser guide | Power workflows for terminal natives |
| Page hotkeys | Vimium-style keys on web pages |
| Keybindings & bangs | bind, bang, rc file, import-vimium-keys |
| Workspaces & layout | layout, split, workspace, ps/kill |
| Shell features | Pipes, aliases, bang expansions, watch |
| Virtual filesystem | Navigate browser state as paths |
| Page commands | DOM inspection and interaction |
| Privacy tools | siteinfo, forget, permissions |
| Configuration | Themes, prompts, aliases, rc file |
| Keyboard shortcuts | Overlay, terminal, and page key reference |
Reference
| Doc | Description |
|---|---|
| Command reference | All 105 commands (auto-generated) |
| Architecture | Technical design for contributors |
Help
| Doc | Description |
|---|---|
| FAQ | Common questions |
| Open source | GitHub repo, contributing, license |
| Privacy policy | Chrome Web Store privacy doc |
| Chrome Web Store permissions | Full permission Q&A for reviewers |
| Permissions | Short summary of each permission |
Getting started
Install BrowserShell and run your first commands in under two minutes.
Core concepts
How BrowserShell thinks — commands, resources, overlay, and the virtual filesystem.
Demo walkthroughs
Step-by-step explanations of real BrowserShell workflows.
Superuser guide
Power workflows for people who live in the terminal.
Shell features
Pipes, aliases, bang expansions, watch mode, and shell builtins.
Virtual filesystem
Navigate browser resources as files and directories.
Page hotkeys
Vimium-style keyboard navigation on web pages — link hints, scroll, omnibar, marks, and tab chords.
Workspaces & window layout
Tile windows, split views, and save multi-window layouts with layout, split, workspace, and workview.
Page commands
Inspect and interact with the current page DOM from the shell.
Privacy tools
Audit and clear site data with forget, siteinfo, and permissions.
Keybindings & bangs
Customize page hotkeys, terminal binds, editor binds, and !bang URL shortcuts.
Configuration
Themes, prompts, hotkeys, aliases, and rc file customization.
Keyboard shortcuts
Complete reference for terminal and overlay shortcuts.
Open source
BrowserShell is MIT licensed. Source, contributing guide, and project resources on GitHub.
Commands
Overview of BrowserShell's 105 built-in commands.
Architecture
How BrowserShell is built — shell, commands, VFS, and Chrome APIs.
FAQ
Frequently asked questions about BrowserShell.