Installation Guide

Via package manager

Arch Linux (AUR)
yay -S g-ls
Homebrew 🍺
brew install g-ls
or use the homebrew tap:
brew tap equationzhao/core [email protected]:Equationzhao/homebrew-g.git
brew install g-ls
Windows Scoop
scoop install
# upgrade
scoop uninstall g # uninstall first
scoop install
TODO, see issue

Pre-built executable

install script
bash -c "$(curl -fsSLk"
curl -fsSLk | bash /dev/stdin -r
download from release page
sudo dpkg -i g_$version_$arch.deb
just download from release page, extract the gzip and add the executable file to your PATH

From source

Requires Go version >= 1.21
go install -ldflags="-s -w"
Alternatively, clone the repo for a dev version:
git clone
cd g
go build -ldflags="-s -w"
# then add the executable file to your `PATH`

Validate Installation

use g -v to check version
g -v # check version
you should see output like this:
💡 g - a powerful ls
| Version 0.11.1
| Go Version 1.20.5
| Compiler gc
| Platform linux/amd64
| Copyright (C) 2023 Equationzhao. MIT License
| This is free software: you are free to change and redistribute it.
| There is NO WARRANTY, to the extent permitted by law.

check new version

g --check-new-version
Last modified 18d ago