QH documentation
Install QH, run the CLI, change its colors, and check shell behavior.
QH is a macOS shell workspace. Each tab or split pane runs an independent shell. Switching tabs and resizing panes keep those processes running.
Choose a task
| Task | Guide |
|---|---|
| Download and open the desktop app | Install QH |
| Run inside an existing terminal | Use the CLI |
| Change folder, shell, font, and tab placement | Edit configuration |
| Customize colors | Create a theme |
| Check input, splits, and process cleanup | Test QH |
| Edit or export these guides | Edit a documentation draft |
| Run custom commands or update CLIs | Quick commands | | Save and restore workspace layouts | Workspace restore |
Version and limits
Both Apple Silicon and Intel builds are available. The app is locally signed and not notarized. Workspace layouts, names, colors, and working folders restore from local SQLite. Reopened shells have fresh PIDs; previous running programs and terminal output are not resumed. Mouse-enabled CLIs receive mouse reports; alternate-screen pagers receive wheel navigation. Shift lets you select text or scroll history.
Source captured: 2026-10-13