quickTerminal/COMMANDS.md at main · LEVOGNE/quickTerminal

              _      _    ____    _    ____
   __ _ _   _(_) ___| | _| __ )  / \  |  _ \
  / _` | | | | |/ __| |/ /  _ \ / _ \ | |_) |
 | (_| | |_| | | (__|   <| |_) / ___ \|  _ <
  \__, |\__,_|_|\___|_|\_\____/_/   \_\_| \_\
     |_|

quickBAR Command Reference

Your complete guide to every command in quickTERMINAL's command bar.

🔍 quickBAR

Tip

Double-tap Ctrl to summon the quickBAR. Type a letter to filter. ← → to navigate. Enter to execute. Esc to dismiss.

Note

Commands with values show the current state in parentheses, e.g. Opacity (99%). Slider/choice commands prompt for a new value. Toggle commands switch instantly.

⚡ Quick Actions

	Command	Shortcut	Description
➕	New Tab	`⌘` `T`	Open a fresh terminal tab
✖️	Close Tab	`⌘` `W`	Close the active tab
🧹	Clear	`⌘` `K`	Wipe the scrollback buffer
👁️	Hide	`Ctrl` + `<`	Hide the terminal window
⚙️	Settings	—	Open preferences overlay
❓	Help	`?`	Open the README viewer
📋	Commands	—	Show this reference
⏹️	Quit	`q`	Exit quickTERMINAL

📏 Split Panes

	Command	Shortcut	Description
➡️	Split Vertical	`⌘` `D`	Side by side panes
⬇️	Split Horizontal	`⇧` `⌘` `D`	Top / bottom panes

🖥️ Window Layout

Tip

Snap your terminal to any position. Toggle commands restore previous size on second use.

	Command	Description
🔄	Fullscreen	Toggle entire desktop
↔️	Horizont	Toggle full screen width (keep height)
↕️	Vertical	Toggle full screen height (keep width)
⬅️	Left	Snap to top-left quadrant (50% × 50%)
➡️	Right	Snap to top-right quadrant (50% × 50%)
🔢	Defaultsize	Reset to 720×480
🔄	Reset Window	Reset size + position under tray icon

🔦 Cursor Commands

	Command	Description
⬛	Cursor Block	Switch to block cursor █
📏	Cursor Beam	Switch to beam cursor ▏
➖	Cursor Underline	Switch to underline cursor ▁
✨	Cursor Blink (on/off)	Toggle cursor blinking

🎨 Appearance Commands

Note

These commands prompt for a value after selection. Type the new value and press Enter.

	Command	Type	Range
🔮	Opacity (99%)	Slider	30–100%
💎	Blur (96%)	Slider	0–100%
✏️	Fontsize (10pt)	Slider	8–18pt
🎨	Theme (default)	Choice	default, cyberpunk, minimal, powerline, retro, lambda, starship
⌨️	Font (Fira Code)	Choice	Fira Code, JetBrains Mono, Monocraft, Iosevka Thin
🚀	Shell (zsh)	Choice	zsh, bash, sh

Git Panel

	Command	Description
	GIT	Toggle Git panel — shows branch, status, diff, recent commits

Note

The Git panel auto-detects the current repository. Toggle position between right side and bottom. Displays: current branch, changed files, staged changes, commit history.

🌐 WebPicker

	Command	Description
🌐	WebPicker	Toggle WebPicker sidebar — connect to Chrome via CDP, pick DOM elements

🔒 SSH Manager

	Command	Description
🔒	SSH	Toggle SSH Manager sidebar — save SSH profiles, connect with one click

Note

Saves profiles with label, user@host, port, and optional identity file. Click ▶ to open a new tab and start the SSH connection. Profiles persist across sessions via UserDefaults.

Note

Connects to Chrome (with --remote-debugging-port=9222). Auto-starts Chrome if needed. States: Disconnected → Connecting → Ready → Picking. Shows live hostname. Click "Pick Element" → hover elements in browser → click to copy outerHTML to clipboard.

📊 Claude Code Usage

	Command	Description
📊	AI Usage Badge	Shows Claude Code session utilization in footer bar

Note

Auto-connects to Claude Code via local credentials. Shows session (5h) and weekly usage. Click the badge for detailed breakdown with progress bars and reset times. Toggle in Settings under "Claude Code". No manual token entry needed.

⚙️ Behavior Toggles

Note

Toggle commands switch the setting instantly. Current state shown in parentheses.

	Command	Default
📌	Always on Top (on/off)	On
🔅	Auto-Dim (on/off)	Off
💡	Syntax Highlighting (on/off)	On
📋	Copy on Select (on/off)	On
👁️	Hide on Click Outside (on/off)	Off
👁️	Hide on Deactivate (on/off)	Off
🔌	Launch at Login (on/off)	Off
🔄	Auto-Check Updates (on/off)	On
🌎	Follow All Spaces (on/off)	Off

🔄 Update

	Command	Description
🔍	Check for Updates	Manually check GitHub for a new version
⬇️	Install Update (vX.Y.Z)	Download + install available update (appears when update found)
🔄	Auto-Check Updates (on/off)	Toggle automatic checks every 72 hours

Note

Updates preserve all settings, tabs, splits, working directories, and window state. The app restarts seamlessly after installing.

🔍 Tools

	Command	Description
🔍	Search	Search through scrollback buffer — highlights matches with auto-clear
📊	Perf	Toggle performance overlay — FPS, draw time, PTY read/write throughput
🔧	Parser	Toggle parser diagnostics — sequence counts, unhandled sequences

⚠️ System

	Command	Description
🚨	Resetsystem	Factory reset — confirmation prompt: `Sure? (y/n)`

⌨️ Keyboard Shortcuts

Important

These shortcuts work globally in quickTERMINAL.

🗂️ Window & Tabs

Shortcut	Action
`Ctrl` + `<`	🚀 Toggle window visibility (global hotkey)
`⌘` `T`	➕ New tab
`⌘` `W`	✖️ Close tab
`⌘` `←` / `→`	↔️ Switch between tabs
`Ctrl` + `1`–`9`	🔢 Switch to tab 1–9 directly
`Ctrl` `⇧` + `1`–`9`	✏️ Rename tab 1–9 (inline edit)
`⌘` `D`	➡️ Split pane vertical
`⇧` `⌘` `D`	⬇️ Split pane horizontal
`Alt` + `Tab`	🔄 Switch split pane focus
`⌘` `K`	🧹 Clear scrollback buffer
`⌘` `C`	📋 Copy selection
`⌘` `V`	📎 Paste from clipboard
`⌘` `A`	✏️ Select all
Double-tap `Ctrl`	🔍 Open quickBAR

🖥️ Window Size Presets

Shortcut	Size	Description
`Ctrl` `⌥` `1`	620 × 340	Compact — minimal footprint
`Ctrl` `⌥` `2`	860 × 480	Medium — default size
`Ctrl` `⌥` `3`	1200 × 680	Large — spacious workspace

Note

All presets animate with a spring transition and center on the current screen.

🔦 Terminal Navigation

Shortcut	Action
`Alt` + `←` / `→`	Move cursor word backward / forward
`Alt` + `Backspace`	Delete word backward
`⌘` + `Backspace`	Kill entire line (Ctrl+U)
`Shift` + `←` / `→` / `↑` / `↓`	Extend text selection

⚡ Signal Controls

Note

Standard Unix signals for process control.

Shortcut	Signal	Effect
`Ctrl` + `C`	SIGINT	⏹️ Interrupt process
`Ctrl` + `Z`	SIGTSTP	🔄 Suspend process
`Ctrl` + `D`	EOF	✖️ End of input
`Ctrl` + `\`	SIGQUIT	⏹️ Quit process
`Ctrl` + `A`-`Z`	—	Standard control characters

🚀 Shell Switching

Tip

quickTERMINAL auto-discovers installed shells at startup. Switch instantly without leaving your workflow.

Shortcut	Shell	Icon
`⌘` `1`	zsh (default)	💎
`⌘` `2`	bash	🔮
`⌘` `3`	sh / fish	🌐

🌐 German Keyboard Specials

Note

Essential mappings for German (QWERTZ) keyboards.

Shortcut	Output	Name
`Alt` + `N`	`~`	Tilde
`Alt` + `5`	`[`	Left bracket
`Alt` + `6`	`]`	Right bracket
`Alt` + `7`	`\|`	Pipe
`Alt` + `8`	`{`	Left brace
`Alt` + `9`	`}`	Right brace

🐁 Mouse Actions

Tip

Hold 0.3 seconds before dragging to start text selection. Selection auto-copies to clipboard (configurable in Settings).

	Action	Effect
🐁	Click	Position cursor / clear selection
👉	Hold 0.3s + Drag	Text selection
💬	Double-click	Select entire word
🔗	`⌘` + Click	Open hyperlink in browser
✋	`⌥` + Click	Drag the window
🖲️	Right-click	Context menu (mouse tracking)
📜	Scroll wheel	Scroll buffer / report to app

⚙️ Settings Overview

Note

Open via quickBAR (Settings) or the ⚙️ gear icon in the footer bar.

🎨 Appearance

Setting	Range	Default
🔮 Window Opacity	`30-100%`	`99%`
💎 Blur Intensity	`0-100%`	`96%`
✏️ Font Size	`8-18pt`	`10pt`
⌨️ Font Family	System monospace	Auto
🔦 Cursor Style	Underline / Beam / Block	Underline
✨ Cursor Blink	On / Off	Off
🎨 Color Theme	Dark / Light / OLED / System	Dark

⚡ Behavior

Setting	Range	Default
📌 Always on Top	On / Off	On
🔅 Auto-Dim	On / Off	Off
👁️ Hide on Click Outside	On / Off	Off
👁️ Hide on Deactivate	On / Off	Off
📋 Copy on Select	On / Off	On
🔌 Auto-Start at Login	On / Off	Off
🔄 Auto-Check Updates	On / Off	On
🌎 Follow All Spaces	On / Off	Off

🎨 Shell & Theme

Setting	Range	Default
🚀 Syntax Highlighting	On / Off	On
💎 Prompt Theme	7 themes	default

🖼️ Prompt Themes

Tip

Switch themes via quickBAR (Theme) or Settings. Each theme styles your prompt differently.

Theme	Style	Vibe
💎 `default`	Clean and minimal	Everyday use
⚡ `cyberpunk`	Neon accents	Hacker aesthetic
🔦 `minimal`	Ultra-stripped	Maximum focus
➡️ `powerline`	Segments with arrows	Status-rich
🎨 `retro`	Classic green phosphor	Nostalgia
🌐 `lambda`	Functional style	Developer
🚀 `starship`	Space-inspired	Exploration

[!IMPORTANT] Double-tap Ctrl to open the quickBAR anytime. Type a letter to filter. ← → to browse. Enter to execute.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly