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
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 updated