# setup-zsh

> setup-zsh is a lightweight one-command Zsh setup for macOS with history-wide autosuggestions, syntax highlighting, a Git-aware prompt and a dev tools installer.

- URL: https://afixer.app/projects/setup-zsh
- Part of: Projects
- Language: en

One-command Zsh setup for macOS with autosuggestions that match anywhere in your history.

- [Source on GitHub](https://github.com/openhoangnc/setup-zsh)

## Install

```
curl -sSL https://raw.githubusercontent.com/openhoangnc/setup-zsh/main/setup.sh | bash
```

- **Runs on**: macOS
- **Built with**: Shell, Zsh
- **First released**: 2026
- **License**: MIT

![setup-zsh developer tool installer listing languages, IDEs and apps with their installed versions](https://afixer.app/projects/setup-zsh.webp)

Most Zsh setups only suggest commands that start with what you typed. This one falls back to searching your whole history for a command that contains it anywhere, marked with a `»` arrow.

## Features

- History search with the arrow keys, syntax highlighting and auto-cd
- A clean prompt showing the Git branch, uncommitted changes and ahead/behind counts
- `install-dev-tool`: an interactive menu to install Bun, Go, Node.js, Python, Rust, a JDK and more
- Uses only built-in tools; no Git or Xcode Command Line Tools needed

In [Lightspot](https://afixer.app/lightspot), type `install` to run this installer in your terminal, or `install node`, `install go` and the like to open `install-dev-tool`. See [installers in Lightspot](https://afixer.app/lightspot/browser-and-system#installers).

## Support

Found a bug or have an idea? [Open an issue on GitHub](https://github.com/openhoangnc/setup-zsh/issues).

## Related projects

- **[Lightspot](https://afixer.app/lightspot)**  
A Spotlight replacement for macOS that never indexes your files. Apps, recent projects, shell history, browser tabs, developer tools, a cleaner for developer caches and Mac Tweaks, which frees the space macOS keeps, turns Apple Intelligence off, changes macOS settings with undo and turns off or deletes other apps' background items, in one search bar.  
No file index
- **[CleanDevMac](https://afixer.app/projects/cleandevmac)**  
Finds the developer caches, build output and leftover app data filling your Mac's disk, and deletes only what you confirm.  
No install
- **[Claude Usage Stats](https://afixer.app/projects/claude-usage-stats)**  
Menu bar app that keeps your Claude Code session and weekly usage in view.  
Session and week %
