Quick Start
Get up and running with Secondary Terminal in under a minute.
Open Your First Terminal
- Click the terminal icon (ST) in the Activity Bar (left sidebar)
- A terminal opens with your default shell
- Start typing commands as you normally would
Basic Operations
| Action | Shortcut |
|---|---|
| New terminal | Click + button in header |
| Close terminal | Ctrl+Shift+X / Cmd+Shift+X |
| Switch terminals | Click tabs, or Alt+1..5 / Cmd+Alt+1..5 |
| Split terminal | Ctrl+Shift+5 / Cmd+\ |
| Find in terminal | Ctrl+F / Cmd+F |
| Clear terminal | Ctrl+K / Cmd+K |
| Copy | Ctrl+C / Cmd+C (when text selected) |
| Paste | Ctrl+V / Cmd+V |
Try AI Agent Integration
Run any supported AI CLI agent in your terminal:
sh
# Claude Code
claude
# GitHub Copilot
copilot
# Gemini CLI
gemini
# Codex CLI
codexWhen an agent is detected, you'll see a status indicator in the terminal header showing the agent name and connection state.
Useful Shortcuts for AI Agents
| Action | Shortcut |
|---|---|
| Insert current file path | Ctrl+Alt+L / Cmd+Alt+L |
| Insert all open files | Ctrl+Alt+A / Cmd+Alt+A |
| Paste screenshot (macOS) | Cmd+V |
Customize Your Terminal
Open settings with Ctrl+, / Cmd+, and search for secondaryTerminal to see all 90+ available settings, including:
- Font: family, size, weight
- Cursor: style (block/underline/bar), blink
- Theme: auto, dark, light
- Scrollback: up to 100,000 lines
- Session: auto-save and restore on restart
Next Steps
- Using with AI Agents -- Deep dive into AI agent workflows
- Features -- Explore all features
- Keyboard Shortcuts -- Full shortcut reference
- Settings -- All configuration options