Terminal
The terminal brings full shell access directly into Blueberry with multi-tab support, session persistence that survives network interruptions, and smart integrations.

✻
|
▟█▙ Claude Code v2.1.45
▐▛███▜▌ Opus 4.6 · Claude Max
▝▜█████▛▘ ~/apps/blueberry-website
▘▘ ▝▝
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
❯ Try "how does route.ts work?"
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
? for short
Multi-Tab Terminal
Run multiple terminal sessions with drag-and-drop tab management:
Tab Features
- Create tabs -
Cmd+Topens a new terminal session - Rename tabs - Double-click tab name
- Reorder tabs - Drag tabs to rearrange
- Tab indicators - Green pulsing dot shows running server
- Startup commands - Configure commands to auto-run when tab opens
Auto-Naming
- Tabs automatically rename to “Server” when a dev server is detected
- Tabs rename to “Claude” when Claude Code is running
- Manual renames are preserved
Session Persistence
Terminal sessions survive network interruptions, laptop sleep, and browser refreshes:
How It Works
- 30-minute grace period - PTY processes stay alive after disconnect
- 50KB output buffer - Recent output replayed on reconnection
- Heartbeat monitoring - Server detects stale connections via ping/pong
Reconnection
- Exponential backoff: 1s → 2s → 4s → 8s → 16s → 30s (max 10 attempts)
- Yellow spinner during reconnection
- Attempt counter: “Reconnecting (attempt 3/10)”
- Reload button after max attempts
Clickable Links
Cmd+click on file paths and URLs in terminal output:
File Links
- Absolute paths:
/Users/foo/project/src/file.ts:42:10 - Relative paths:
./src/file.ts,src/file.ts - With line numbers:
file.ts:42orfile.ts:42:10 - Opens file in editor at specified line
URL Links
- Full URLs:
https://example.com - Localhost:
localhost:3000,127.0.0.1:8080 - Opens in preview browser panel
Server Auto-Detection
Blueberry automatically detects when you start a dev server:
Detection Process (macOS)
- Monitors child processes every 2 seconds
- Scans for listening ports via
lsof - Verifies HTTP server with HEAD request
- Notifies via WebSocket message
When Server Detected
- Tab auto-renames to “Server”
- Green pulsing indicator appears on tab
- Preview browser can auto-navigate to server URL
Terminal Settings
Per-Tab Settings
- Tab name (with manual override protection)
- Startup command (auto-runs on tab open)
Global Settings
- Font size (adjustable)
- Scrollback buffer: 5000 lines
Keyboard Shortcuts
| Action | Shortcut |
|---|---|
| New terminal tab | Cmd+T |
| Close current tab | Cmd+W |
| Line continuation | Shift+Enter |
| Delete to line start | Cmd+Backspace |
| Delete word | Opt+Backspace |
| Jump to line start/end | Cmd+Left/Right |
| Jump word | Opt+Left/Right |
Last updated on