Installation

Installation

Download a Binary (no Go required)

Pre-built binaries are available for macOS, Linux, and Windows on the Releases page.

macOS / Linux — one-liner (auto-detects OS and architecture):

curl -fsSL https://raw.githubusercontent.com/wricardo/gqlcli/main/install.sh | bash

Installs to /usr/local/bin/gqlcli. Override with INSTALL_DIR:

INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/wricardo/gqlcli/main/install.sh | bash

macOS

Apple Silicon (M1/M2/M3):

curl -L https://github.com/wricardo/gqlcli/releases/latest/download/gqlcli_darwin_arm64.tar.gz | tar xz
sudo mv gqlcli /usr/local/bin/

Intel:

curl -L https://github.com/wricardo/gqlcli/releases/latest/download/gqlcli_darwin_amd64.tar.gz | tar xz
sudo mv gqlcli /usr/local/bin/

Linux

x86_64:

curl -L https://github.com/wricardo/gqlcli/releases/latest/download/gqlcli_linux_amd64.tar.gz | tar xz
sudo mv gqlcli /usr/local/bin/

ARM64:

curl -L https://github.com/wricardo/gqlcli/releases/latest/download/gqlcli_linux_arm64.tar.gz | tar xz
sudo mv gqlcli /usr/local/bin/

Windows

Download gqlcli_windows_amd64.zip from the Releases page, extract it, and move gqlcli.exe to a directory in your PATH.

Verify

gqlcli --help

---

Install with Go

If you have Go 1.20+ installed:

go install github.com/wricardo/gqlcli/cmd/gqlcli@latest

The binary is installed to $GOPATH/bin or $HOME/go/bin. Make sure that directory is in your PATH.

---

Build from Source

git clone https://github.com/wricardo/gqlcli.git
cd gqlcli
make install

The install target builds and copies the binary to $GOPATH/bin.

Other useful targets:

make build    # Build to ./bin/gqlcli
make dev      # Build and run tests
make help     # List all targets

---

As a Go Library

go get github.com/wricardo/gqlcli

Then import:

import gqlcli "github.com/wricardo/gqlcli/pkg"

For usage examples, see Library-HTTP-Mode and Library-Inline-Mode.

---

Updating

# Binary: re-download from the Releases page, or:
go install github.com/wricardo/gqlcli/cmd/gqlcli@latest

# From source:
cd gqlcli && git pull && make install