# Qesh documentation

Qesh 0.4.0 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 Qesh](/docs/qesh/install) |
| Run inside an existing terminal | [Use the CLI](/docs/qesh/cli) |
| Change folder, shell, font, and tab placement | [Edit configuration](/docs/qesh/configuration) |
| Customize colors | [Create a theme](/docs/qesh/themes) |
| Check input, splits, and process cleanup | [Test Qesh](/docs/qesh/testing) |
| Edit or export these guides | [Edit a documentation draft](/docs/qesh/editing) |

| Run custom commands or update CLIs | [Quick commands](/docs/qesh/commands) |
| Save and restore workspace layouts | [Workspace restore](/docs/qesh/workspaces) |

## 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 input supports workspace controls and selection, but is not forwarded to child terminal programs.

[Source code](https://github.com/qentrah/qesh) · [Release notes](https://github.com/qentrah/qesh/releases/tag/v0.4.0) · [Report a bug](https://github.com/qentrah/qesh/issues)