Install qh and configure quick commands

Install and quick commands

Qesh 0.4.0 includes the Node.js qh command. The managed macOS installer bundles both Node and Bun:

1curl -fsSL https://qentrah.com/qesh/install.sh -o /tmp/qesh-install.sh
2sh /tmp/qesh-install.sh
3~/.local/bin/qh help
4~/.local/bin/qh

The installer downloads the native Apple Silicon or Intel release from GitHub, verifies SHA-256 and the app signature, and installs into a versioned local folder. It creates qh and qesh launchers in ~/.local/bin; add that folder to your shell PATH if necessary. It refuses to replace unrelated commands. QESH_BIN_DIR and QESH_INSTALL_DIR choose other destinations. The app is locally signed and not notarized.

1qh config             # Open the global configuration
2qh config path        # Print its path
3qh config validate    # Validate JSON and settings
4qh update --check     # Check Qesh releases
5qh update             # Update a managed install if a newer version exists
6qh update-all --dry-run
7qh update-all         # Run only the updates you configured
8qh workspace list     # List saved workspace records
9qh workspace Research # Open a named CLI workspace

gh remains GitHub CLI. Qesh uses qh. For a source checkout, run ./bin/qh; update the checkout with Git rather than the managed installer. Node.js 22.13+ and Bun 1.3.5+ are required for source development. Packaged downloads supply their runtimes.

Custom commands and CLI updates

Add command objects to your global configuration. No CLI updates are enabled by default.

1{
2  "commands": {
3    "dev": {
4      "command": "npm run dev",
5      "cwd": "~/Documents/my-project",
6      "description": "Start the development server"
7    }
8  },
9  "updates": {
10    "codex": { "command": "npm install -g @openai/codex" },
11    "claude": { "command": "npm install -g @anthropic-ai/claude-code" },
12    "opencode": { "command": "opencode upgrade" }
13  }
14}

Run qh dev to execute a configured command with your shell and permissions. Desktop Commands lists these shortcuts and starts the selected command in a new tab. Command names use lowercase letters, digits, and hyphens; built-in names are reserved. Custom command arguments belong in the JSON command string. qh update-all runs the configured list in order and stops on the first failure. It does not discover or change other installed CLIs. updateChannel accepts preview (default) or stable.