Documentation
From first install to advanced configuration in minutes.
Getting Started
Install Blade and launch your first terminal session in under a minute.
- Download for Windows, macOS, or Linux
- Package managers: scoop, brew, cargo
- First launch and shell setup
- Verify with blade doctor
Configuration
Customize fonts, themes, keybindings, and behavior via TOML config with live hot-reload.
- blade.toml location and structure
- Window, font, color, cursor settings
- Scrollback and keybinding presets
- Hot-reload (changes apply instantly)
Keybindings
Default shortcuts and how to customize them. Includes presets for default, vim, and emacs workflows.
- Default, vim, and emacs presets
- Tab management shortcuts
- Custom keybinding configuration
- send_bytes for raw escape sequences
Themes
5 built-in color schemes with live previews, plus custom theme creation.
- Catppuccin, Dracula, Nord, Solarized, Tokyo Night
- Color swatch previews
- Custom theme TOML format
- Manual color overrides
Claude Code
Get Claude Code running in Blade with full compatibility for every feature.
- Install and launch Claude Code
- Full compatibility table
- Shift+Enter, colors, keyboard protocol
- Recommended configuration
Multiplayer
Share terminal sessions in real-time with encrypted communication.
- Starting and sharing sessions
- QR pairing and auto-discovery
- Driver and observer roles
- E2E encryption and web client
CLI Reference
Complete reference for all Blade commands, flags, and options.
- blade, blade doctor, blade serve
- blade install, blade search
- Command flags and options
- Example output
Cloud
On-demand cloud dev environments with Claude Code pre-installed.
- Creating and managing instances
- Hibernate, resume, and billing
- Workspace persistence
- Security and isolation
Troubleshooting
Common issues, platform-specific notes, and how to get help.
- GPU, font, and config issues
- Windows, macOS, Linux notes
- blade doctor diagnostics
- Getting help