Install Qesh on macOS

Download

Choose the processor shown in Apple menu → About This Mac:

Apple M-series: Apple Silicon ZIP.
Intel processor: Intel ZIP.

The app bundles Bun, Node.js, and terminal dependencies. You do not need to install these separately to use the downloaded desktop app.

Open the app

Extract the ZIP into a writable folder.
Open Qesh.app; configuration and SQLite are stored in the local application data folder.
Open Qesh.app.
Use the three-dot menu → New Tab to create another shell.

A shell should appear with a prompt. Type pwd and press Enter to check its starting folder.

This preview is not notarized. If macOS blocks it, check System Settings → Privacy & Security for the approval control. If configuration cannot be saved, check that your local application data folder is writable.

Verify a download

Download the matching checksum: Apple Silicon or Intel. Keep it beside the matching ZIP, then run the appropriate command in that folder:

1shasum -a 256 -c Qesh-macOS-arm64.sha256
2# For an Intel download instead:
3shasum -a 256 -c Qesh-macOS-x64.sha256

Expect the matching ZIP filename followed by OK. A mismatch means the file does not match the published checksum; download it again before opening it.

Continue with configuration or CLI setup.