View all results

Install

The Ferret CLI runs on Linux, macOS, and Windows. Full installation instructions, including how to embed Ferret as a Go library and set up browser support, are in the Installation guide.

This page covers CLI-specific setup.

From a prebuilt binary

Download v2.0.0-alpha.35 for your platform from the CLI release page.

After downloading, make sure the binary is available in your PATH.

From source

Requires Go 1.26.5 or later:

terminal 
go install github.com/MontFerret/cli/v2/ferret@v2.0.0-alpha.35

Verify installation

terminal 
ferret version

This prints the CLI version and the runtime version.

Update

The CLI can update itself to the latest release:

terminal 
ferret update self

This downloads the latest binary for your platform and replaces the current installation.

Uninstall

Remove the ferret binary from your PATH and, optionally, delete the configuration directory:

terminal 
rm -rf ~/.ferret

Next steps

Execution Run Execute FQL scripts from files, inline expressions, stdin, or compiled artifacts. Modules Mod Discover, install, initialize, and publish Ferret modules. Interactive REPL Launch an interactive FQL shell for experimenting with queries. Try Run your first script Execute a Ferret script against static or dynamic content.