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 automatically download and install updates:

1. Click the button in the top-left to open the sidebar
2. Click Settings in the sidebar
3. Click App
4. Scroll down to the Updates section:
   • Check if your current version is "up to date" or if a newer version is available
   • To automatically download the newer version, click Check for Updates
5. Click Install & Restart to immediately relaunch goose Desktop and apply the update
   Note: If the app can't be automatically updated, you'll be prompted to manually install the downloaded version

To manually download and install updates:

1. Click one of the buttons below to download goose Desktop for macOS:

   macOS Silicon macOS Intel
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/block/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 automatically download and install updates:

1. Click the button in the top-left to open the sidebar
2. Click Settings in the sidebar
3. Click App
4. Scroll down to the Updates section:
   • Check if your current version is "up to date" or if a newer version is available
   • To automatically download the newer version, click Check for Updates
5. Click Install & Restart to immediately relaunch goose Desktop and apply the update
   Note: If the app can't be automatically updated, you'll be prompted to manually install the downloaded version

To manually download and install updates:

1. Click one of the buttons below to download goose Desktop for Linux:

   DEB Package (Ubuntu/Debian) RPM Package (RHEL/Fedora)

For Debian/Ubuntu-based distributions

2. In a terminal, navigate to the downloaded DEB file
3. Run sudo dpkg -i (filename).deb
4. 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/block/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 automatically download and install updates:

1. Click the button in the top-left to open the sidebar
2. Click Settings in the sidebar
3. Click App
4. Scroll down to the Updates section:
   • Check if your current version is "up to date" or if a newer version is available
   • To automatically download the newer version, click Check for Updates
5. Click Install & Restart to immediately relaunch goose Desktop and apply the update
   Note: If the app can't be automatically updated, you'll be prompted to manually install the downloaded version

To manually download and install updates:

1. Click one of the buttons below to download goose Desktop for Windows:

   Windows
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/block/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/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash