Install Cue

Cue supports Apple Silicon Macs running macOS 13 or later. Its zsh integration works in Apple Terminal and the VS Code integrated terminal. Homebrew installs Cue and its Node.js dependency.

InstallCopy Anchor Link

Run these commands in a terminal:

brew tap 8starlabs/cue https://github.com/8starlabs/cue.git
brew install 8starlabs/cue/cue

Enable Cue in zshCopy Anchor Link

Add Cue to your zsh startup file so it loads in every new zsh session:

echo 'source "$(brew --prefix)/opt/cue/share/cue/zsh/cue.zsh"' >> ~/.zshrc

Then open a new Terminal window or create a new integrated terminal in VS Code. Existing shells do not load the change automatically. Homebrew also prints the source line after installation.

If VS Code's integrated terminal is not using zsh, run Terminal: Select Default Profile from the Command Palette, choose zsh, and create a new terminal. Cue uses the same zsh integration there; it does not require a VS Code extension.

If macOS asks for permission, allow Cue under System Settings → Privacy & Security → Accessibility so the popup can follow the caret.

Check your Cue versionCopy Anchor Link

For a Homebrew installation, run:

brew list --versions cue

Homebrew prints the installed version, for example cue 0.1.0. To compare it with the latest version available from the tap, run brew update and then brew info 8starlabs/cue/cue. Cue does not currently have a cue --version command.

Type a command such as git ch to see suggestions:

Cue

dev@cue ~/work/project %

checkout[branch, file, tag or commit]

cherry-pick<commit>

commit-m "message"

clean<path>

Switch branches or restore working tree files

(⌘I)

See Update Cue to install future releases, or Uninstall Cue to remove it.