Updating goose

The goose CLI and desktop apps are under active and continuous development. To get the newest features and fixes, you should periodically update your goose client using the following instructions.

macOS

goose Desktop

Update goose to the latest stable version.

To manually download and install updates: 1. 2. Unzip the downloaded zip file 3. Drag the extracted Goose.app file to the Applications folder to overwrite your current version 4. Launch goose Desktop

goose CLI

You can update goose by running:

goose update

Additional options:

# Update to latest canary (development) version
goose update --canary

# Update and reconfigure settings
goose update --reconfigure

Or you can run the installation script again:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

To check your current goose version, use the following command:

goose --version

Linux

goose Desktop

Update goose to the latest stable version.

To manually download and install updates: 1.

For Debian/Ubuntu-based distributions

In a terminal, navigate to the downloaded DEB file
Run sudo dpkg -i (filename).deb
Launch goose from the app menu

goose CLI

You can update goose by running:

goose update

Additional options:

# Update to latest canary (development) version
goose update --canary

# Update and reconfigure settings
goose update --reconfigure

Or you can run the installation script again:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

To check your current goose version, use the following command:

goose --version

Windows

goose Desktop

Update goose to the latest stable version.

To manually download and install updates: 1. 2. Unzip the downloaded zip file 3. Run the executable file to launch the goose Desktop app

goose CLI

You can update goose by running:

goose update

Additional options:

# Update to latest canary (development) version
goose update --canary

# Update and reconfigure settings
goose update --reconfigure

Or you can run the installation script again in Git Bash, MSYS2, or PowerShell to update the goose CLI natively on Windows:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

To check your current goose version, use the following command:

goose --version

Update via Windows Subsystem for Linux (WSL)

To update your WSL installation, use goose update or run the installation script again via WSL:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

Updating in CI/CD

If you're running goose in CI or other non-interactive environments, pin a specific version with GOOSE_VERSION for reproducible installs. See CI/CD Environments for a complete example and usage details.