zest app icon

zest

An autocomplete popup for zsh on macOS. Subcommands, options, files and git branches, with descriptions, right under your cursor in Terminal, iTerm2, Ghostty, VS Code and Cursor.

zest suggesting git branches, npm scripts, docker options and folders while typing in the terminal
curl -fsSL https://raw.githubusercontent.com/rostik32/zest/main/install.sh | sh

A free alternative to the Fig, Amazon Q and Kiro CLI autocomplete

zest does the one thing Fig, and later Amazon Q and Kiro CLI, did best: the completion popup. It is a small native app instead of a web view with a terminal proxy in front of every shell.

How to use it

TabInsert the selected suggestion
↑ ↓Choose a suggestion
EnterInsert while you are typing a word; after a space it runs the command
EscClose the popup for this line
→Accept the grey suggestion from your history

Add your own command

# ~/.config/zest/specs/deploy.yaml
name: deploy
description: Deploy the app
subcommands:
  - name: staging
    description: Deploy to staging
  - name: production
    description: Deploy to production
    options:
      - name: [-f, --force]
        description: Skip the confirmation

Changes are picked up right away. See Adding a command and the spec format reference.

FAQ

Can zest replace Fig, Amazon Q or Kiro CLI?

For the autocomplete popup, yes. zest uses the same open-source command specs Fig used, so the suggestions will look familiar. It does only completion: there is no AI chat, no account and no cloud service.

Which terminals does it work in?

Terminal.app, iTerm2, Ghostty, VS Code and Cursor are tested. Other terminals work if they report the position of the text cursor through macOS Accessibility.

Does it support bash or fish, or Intel Macs?

Not yet. zest needs zsh (the default shell on macOS), macOS 14 or later and an Apple silicon Mac.

How is it different from zsh-autocomplete or zsh-autosuggestions?

Those are zsh plugins that draw inside the terminal. zest is a separate app that shows a floating popup with a description and an icon for every suggestion, from specs for 1,500 commands.

Does zest send my commands anywhere?

No. Everything runs on your Mac.