Auto Setup

github.com/gustavohellwig/gh-zsh Linux Apps Open-source projectOpen source

gh-zsh sets up a shell environment for Ubuntu and macOS with components including the Powerlevel10k theme.

github.com/gustavohellwig/gh-zsh
Auto Setup homepage screenshot

About Auto Setup

Auto Setup is a repository containing a script that configures a zsh shell environment on Ubuntu and macOS. The script installs and configures the Powerlevel10k theme, zsh-completions, zsh-autosuggestions, and fast-syntax-highlighting, along with completion, history, and key-binding settings. It also adds a set of shell aliases, with some aliases specific to Linux.

Installation is done with a single command that downloads the script and pipes it to bash. If a zsh configuration already exists, the script backs it up to a dated .zshrc-backup file. The README notes that the prompt's text and icons may display incorrectly unless the terminal uses a Nerd font. The README lists the Ubuntu and macOS versions it was tested on, so other versions are not covered by that testing.

Key features

  • Installs the Powerlevel10k zsh theme with a preconfigured .p10k.zsh file
  • Adds zsh-completions and zsh-autosuggestions
  • Adds fast-syntax-highlighting for the command line
  • Includes completion, history, and key-binding configuration from oh-my-zsh
  • Sets directory navigation aliases such as .. and ... and colored grep
  • Sets Linux-only aliases for bat, ls, and la
Best for: Developers and terminal users on Ubuntu or macOS who want a ready-made zsh setup with a theme, completion, and autosuggestions.
Good for
  • Open source, released under the CC0-1.0 license
  • Installs multiple zsh components with one command
  • Backs up an existing zsh configuration before changes are applied
Watch out for
  • Prompt text and icons may look broken unless the terminal uses a Nerd font
  • Tested only on Ubuntu 20.04 and 22.04 and macOS 10.14, 11.3, and 14.3.1
  • Installation pipes a script downloaded from the internet directly to bash

Auto Setup at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Platforms
Linux, macOS
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

Auto Setup alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Heads

github.com/linuxboot/heads

Heads provides a minimal Linux boot environment running as a coreboot or LinuxBoot ROM payload for laptops, workstations, and servers.

Open source
24 alternatives

Popular in Linux Apps

Well-known listings from the same topic.

All 222

Auto Setup FAQ

What happens to an existing zsh configuration?
If you already use zsh, your zsh configuration is backed up to a file named .zshrc-backup with a date.
What should I do if the text or icons look broken?
The README advises making sure your terminal uses one of the Nerd fonts.
Which operating system versions has it been tested on?
The README lists testing on Ubuntu 20.04 and 22.04 and macOS 10.14, 11.3, and 14.3.1.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing