Installation

You can install the WriftAI CLI (wriftai) on Linux, macOS, or Windows using your preferred package manager or by downloading prebuilt binaries from the Releases page.

Homebrew (macOS & Linux)

brew install wriftai/tap/wriftai

To upgrade:

brew upgrade wriftai

Scoop (Windows)

scoop bucket add wriftai https://github.com/wriftai/scoop-bucket.git
scoop install wriftai

To upgrade:

scoop update wriftai

Linux Packages (deb, rpm, apk, archlinux)

Prebuilt packages are available for multiple architectures. Download the file that matches your distro and architecture from the Releases page. Filenames look like:

wriftai_<VERSION>_linux_<ARCH>.(deb|rpm|apk|pkg.tar.zst)

Debian / Ubuntu (.deb)

sudo dpkg -i wriftai_<VERSION>_linux_<ARCH>.deb

Fedora / RHEL / CentOS (.rpm)

sudo rpm -i wriftai_<VERSION>_linux_<ARCH>.rpm

Alpine (.apk)

sudo apk add --allow-untrusted wriftai_<VERSION>_linux_<ARCH>.apk

Arch Linux (.pkg.tar.zst)

sudo pacman -U wriftai_<VERSION>_linux_<ARCH>.pkg.tar.zst

Manual Installation (Binaries)

Download the appropriate archive for your OS and architecture from the Releases page:

# Example for Linux (x86_64)
tar -xzf wriftai_Linux_x86_64.tar.gz
sudo mv wriftai /usr/local/bin/

Install via Go Modules

You can also install the CLI via go modules without the help of package managers.

go install github.com/wriftai/cli@latest

Add a symlink to the binary in $PATH for easier access:

sudo ln -s "$(go env GOPATH)/bin/cli" /usr/local/bin/wriftai

Build from Source

To build the latest development version, you’ll need Go 1.22+ installed.

git clone https://github.com/wriftai/cli.git
cd cli
make build

This produces a wriftai binary in the /tmp/bin/ directory.

You can then run:

sudo mv /tmp/bin/wriftai /usr/local/bin/

GitHub Actions

To use this CLI in GitHub workflows, we provide an official installation action.

If you installed wriftai using Homebrew, Scoop, or a Linux package, shell completions for Bash, Zsh, Fish, and PowerShell are installed automatically. If they don’t load right away, restart your shell.

If you installed manually or built from source, you can generate them on demand:

wriftai completion <shell>

For example:

wriftai completion bash
wriftai completion zsh
wriftai completion fish
wriftai completion powershell

You can then add the output to your shell’s completion directory or source it directly. See wriftai completion --help for more information.

Man Pages

WriftAI CLI includes prebuilt Unix-style man pages that provide documentation for each command.

Automatic Installation (Linux/macOS)

If you installed wriftai using Homebrew, Scoop, or a Linux package, the man pages are installed automatically in the standard system location:

/usr/share/man/man1/wriftai.1

You can directly view them using:

man wriftai

Manual Installation (Linux/macOS)

If you installed wriftai manually via archive — refer to Manual Installation (Binaries) — the man pages are included in the archive and will be available after extraction.

To view them directly:

man -l ./man/wriftai.1

To install them system-wide:

sudo cp man/*.1 /usr/share/man/man1/

After installation, you can use:

man wriftai

If you built from source — refer to Build from Source — generate the man pages first:

make man

Then install and view them as above.

Verify Installation:

wriftai version