Vapor provides a rich set of features for an enhanced terminal experience.
- Tab Management
- Split Panes
- File Sidebar
- Monaco Editor
- Smart Context Detection
- Layout Management
- Shell Integration
- Keyboard Navigation
- Search
- Customization
- Keyboard:
Cmd+T - Menu: File → New Tab
- Click: + button in tab bar
Each tab starts with a single terminal pane running your default shell.
- Keyboard:
Cmd+[/Cmd+]- Previous/Next tabCmd+1throughCmd+9- Jump to specific tab
- Mouse: Click tab in tab bar
- Trackpad: Two-finger swipe left/right
- Keyboard:
Cmd+W - Menu: File → Close Tab
- Click: × button on tab
- Close All PTYs: All terminal sessions in the tab are terminated
- Double-click tab title
- Type new name
- Press Enter to save
- Press Escape to cancel
Smart Naming:
- Tabs auto-update based on context (current directory, running process)
- Custom names persist and override auto-naming
- Clear custom name by entering blank name
Drag and drop tabs to reorder them in the tab bar.
- Horizontal Split:
Cmd+D- Splits pane side-by-side
- New pane on right
- Vertical Split:
Cmd+Shift+D- Splits pane top-to-bottom
- New pane on bottom
Drag the divider between panes to resize.
Constraints:
- Minimum size: 10% of parent
- Maximum size: 90% of parent
- Keyboard:
Cmd+W(closes focused pane) - Click: × button in pane corner
- Last Pane: Closing the last pane closes the tab
- Mouse: Click in pane to focus
- Keyboard:
Option+Shift+Arrowto move focusOption+Shift+Left- Focus left paneOption+Shift+Right- Focus right paneOption+Shift+Up- Focus upper paneOption+Shift+Down- Focus lower pane
- Keyboard:
Cmd+B - Menu: View → Toggle Sidebar
- Click folder icon in sidebar header
- Choose directory in system dialog
- Sidebar shows file tree
- Expand/Collapse: Click folder name or arrow icon
- Open File: Double-click file name
- Select: Single-click to select (shows in editor)
- Create File: Right-click → New File
- Create Folder: Right-click → New Folder
- Rename: Right-click → Rename
- Delete: Right-click → Delete
- Reveal in Finder: Right-click → Show in Finder
- Git Root Detection: Automatically finds
.gitdirectory - Status Indicators: (planned)
- Modified files
- Untracked files
- Staged changes
From Sidebar: Double-click file in file tree
From Terminal:
# Not yet implemented - planned feature
vapor /path/to/file- Syntax Highlighting: Auto-detected by file extension
- Line Numbers: Always visible
- Minimap: Code overview on right
- Find/Replace:
Cmd+Fto find,Cmd+Option+Fto replace - Multi-cursor:
Cmd+Dto select next occurrence - Go to Definition:
Cmd+ClickorF12
- Keyboard:
Cmd+S - Auto-save: (planned) Optional auto-save on focus loss
- Keyboard:
Cmd+W - Click: × button in editor pane
Note: Only one editor pane allowed per tab (opens in existing if present)
Vapor automatically detects SSH connections:
Detection Methods:
- OSC 7 Sequence:
hostnamein sequence - Prompt Parsing: Debian/RHEL-style prompts
- SSH Config: Reads
~/.ssh/configfor known hosts
Visual Indicators:
- Green badge with hostname in tab
Tab Naming:
- Tabs auto-update with SSH hostname
- Example: "example.com:/home/user"
Detects when running inside Docker container:
Detection Methods:
- Container Name: Parsed from
docker execcommand - Process Tree: Identifies Docker process
Visual Indicators:
- Blue badge with container name in tab
Tracks working directory on remote systems:
OSC 7 Support:
- Remote shells send directory updates
- Displayed in tab title
- Used for layout restore
Fallback:
- Parses prompt for CWD if OSC 7 unavailable
Shows command exit status:
Visual Indicators:
- Green indicator for success (exit 0)
- Red indicator for failure (exit non-zero)
- Appears briefly after command completes
Implementation:
- OSC 133;D sequence from shell integration
- Fades after 3 seconds (
COMMAND_STATUS_DISPLAY_MS = 3000)
Method 1: Named Layout
- Menu → View → Save Layout...
- Enter layout name
- Click Save
Method 2: Auto-save (planned)
- Layouts auto-saved on quit
- Restored on launch
Per Tab:
- Tab name
- Pane structure (splits, ratios)
- Terminal CWDs
- Running commands (for restore)
- Sidebar visibility
Not Saved:
- Terminal scrollback history
- Editor content (files saved separately)
- Temporary state
From Menu:
- Menu → View → Restore Layout
- Select saved layout
- Current tabs closed
- Layout restored
Restore Behavior:
- Creates PTY sessions with saved CWDs
- Re-runs saved commands (if any)
- Restores split ratios
- Sets tab names
List Layouts:
- Menu → View → Manage Layouts
Delete Layout:
- Select layout → Delete
Storage:
- Layouts saved in
~/.vapor/layouts.json
Vapor provides enhanced terminal features through shell integration.
- zsh - Full support
- bash - Full support
- fish - Partial support (planned)
OSC 133 Sequences:
OSC 133;A- Prompt startOSC 133;B- Command startOSC 133;C- Command executedOSC 133;D;exitcode- Command completed
Use Cases:
- Command status indicators
- Jump to command (planned)
- Command history (planned)
OSC 7 Sequence:
\e]7;file://hostname/path\e\\
Benefits:
- Tab names reflect current directory
- New splits inherit CWD
- Layout restore preserves CWD
Automatic:
- Vapor automatically injects shell integration
- No manual setup required
Manual (if needed):
zsh:
# Add to ~/.zshrc
__vapor_precmd() {
local e=$?
print -Pn "\e]133;D;${e}\a"
return $e
}
__vapor_preexec() {
print -Pn "\e]133;C\a"
}
precmd_functions+=(__vapor_precmd)
preexec_functions+=(__vapor_preexec)bash:
# Add to ~/.bashrc
__vapor_prompt() {
local e=$?
printf "\e]133;D;%d\a" "$e"
return $e
}
PROMPT_COMMAND="__vapor_prompt${PROMPT_COMMAND:+;$PROMPT_COMMAND}"| Shortcut | Action |
|---|---|
Cmd+T |
New tab |
Cmd+N |
New window |
Cmd+W |
Close tab/pane |
Cmd+Q |
Quit application |
Cmd+, |
Settings |
Cmd+K |
Clear terminal |
Cmd+F |
Find in terminal |
Cmd+Shift+O |
Open folder |
| Shortcut | Action |
|---|---|
Cmd+[ |
Previous tab |
Cmd+] |
Next tab |
Cmd+1-9 |
Jump to tab 1-9 |
Cmd+Shift+[ |
Move tab left |
Cmd+Shift+] |
Move tab right |
| Shortcut | Action |
|---|---|
Cmd+D |
Split horizontal |
Cmd+Shift+D |
Split vertical |
Option+Shift+Left |
Focus left pane |
Option+Shift+Right |
Focus right pane |
Option+Shift+Up |
Focus up pane |
Option+Shift+Down |
Focus down pane |
| Shortcut | Action |
|---|---|
Cmd+C |
Copy (with selection) |
Cmd+V |
Paste |
Cmd+K |
Clear scrollback |
Cmd+F |
Search |
Cmd++ |
Increase font size |
Cmd+- |
Decrease font size |
Cmd+0 |
Reset font size |
| Shortcut | Action |
|---|---|
Cmd+S |
Save file |
Cmd+F |
Find |
Cmd+H |
Replace |
Cmd+G |
Find next |
Cmd+Shift+G |
Find previous |
Cmd+/ |
Toggle comment |
Open Search: Cmd+F
Features:
- Case Sensitive: Toggle with button
- Whole Word: Match entire words only
- Regex: Use regular expressions
- Navigate Results: Enter to find next, Shift+Enter to find previous
Open Search: Cmd+F (in editor)
Features:
- Find and replace
- Match case
- Whole word
- Regular expression
- Multi-file search (planned)
Vibrancy:
- Frosted glass effect (requires
background.transparent: true) - Configurable in settings or config file
- Options:
under-window,fullscreen-ui,header,sidebar
Transparency:
- Adjust background alpha in theme
- Example:
"background": "rgba(0, 0, 0, 0.7)"
Colors:
- Full 16-color ANSI palette
- Cursor, selection, foreground, background
- See Configuration
Font Family:
- Any installed monospace font
- Ligature support (if font provides)
Font Size:
- 8-32 pixels
Cmd++/Cmd+-to adjust on-the-fly
Custom Shell:
- Configure path and arguments
- Example: fish, dash, custom shell
Environment:
- Inherits parent environment
- Vapor adds
VAPOR_SHELL_INTEGRATION=1
Reorganize panes by moving them:
- Enable move mode (planned feature)
- Click pane to select
- Click destination to move
- Exit move mode
Quick access to all commands:
Cmd+Shift+Pto open- Type to filter
- Enter to execute
Save terminal configurations:
- Shell settings
- Environment variables
- Starting directory
- Window size