Docs
Configuration
Themes, prompts, hotkeys, aliases, and rc file customization.
Options page
Open via the extension icon, or run:
config
Appearance
| Setting | Description |
|---|---|
| Theme | Built-in presets (GitHub Dark, Dracula, etc.) + custom themes |
| Font family | Monospace font selection |
| Font size | Terminal font size |
| Line height | Line spacing |
| Letter spacing | Character spacing |
| Cursor style | Block, underline, or bar |
Prompt
Default template: \u@\h:\w$
| Token | Value |
|---|---|
\u | Username (from env) |
\h | Current site domain |
\w | Virtual cwd |
Example: [\u@\h \w]$ → [you@github.com /tabs]$
Toggle key
Default: backtick (`). Rebind to any key. Also assign Ctrl+Shift+K at chrome://extensions/shortcuts.
Page keys
| Setting | Default | Description |
|---|---|---|
| Global hotkeys | On | Vimium-style keys when overlay is closed |
| Insert mode auto | On | Pause hotkeys while typing in inputs |
| Leader key | <space> | Prefix for chords like <leader>e |
| Disabled hosts | (empty) | Comma-separated host patterns to skip |
| Hint characters | Home row | Letters used for link hint badges |
| Keybindings file | /config/rc | bind, bang, and alias definitions |
Page hotkeys activate on load without an extra click. Configure in Options → Page keys or edit bind lines in the rc file.
Forget presets
Named profiles for forget --preset <name>. Define scope: cookies, cache, storage, history inclusion.
Editor (beta)
The built-in edit command uses simple mode (arrow keys, type, Ctrl+S save). Full Vim editing is not ready yet — see FAQ.
rc file (startup)
Editable in options or via VFS:
cat /config/rc
edit /config/rc # built-in editor (Ctrl+S to save)
source /config/rc
Example rc:
# Aliases
alias ll='tabs'
alias hn='go news.ycombinator.com'
alias triage='tabs | grep -v pinned'
# Environment
export USER=jamal
export EDITOR=vim
# Runs on shell init
Aliases
alias name='command'
alias # list all
Aliases expand before parsing. Support single-level substitution.
Custom themes
Create in Options → Custom Themes:
- Background, foreground, cursor colors
- ANSI color palette
- Prompt and accent colors
Themes persist in config and apply immediately.
Export and backup
export # export config
cat /config/settings.json
Back up aliases, themes, presets, and rc before reinstalling.
Command history
- Stored in config, persists across sessions
- Navigate with
↑/↓ - Reverse search:
Ctrl+R - Clear in options page