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
- Linux
- Windows
- goose Desktop
- goose CLI
Update goose to the latest stable version.
To automatically download and install updates:
- Click the button in the top-left to open the sidebar
- Click
Settingsin the sidebar - Click
App - Scroll down to the
Updatessection:- 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
- Click
Install & Restartto 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:
-
Click one of the buttons below to download goose Desktop for macOS:
- Unzip the downloaded zip file
- Drag the extracted
Goose.appfile to theApplicationsfolder to overwrite your current version - Launch goose Desktop
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
- goose Desktop
- goose CLI
Update goose to the latest stable version.
To automatically download and install updates:
- Click the button in the top-left to open the sidebar
- Click
Settingsin the sidebar - Click
App - Scroll down to the
Updatessection:- 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
- Click
Install & Restartto 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:
-
Click one of the buttons below to download goose Desktop for Linux:
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
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
- goose Desktop
- goose CLI
Update goose to the latest stable version. How an update is applied depends on how goose Desktop was installed:
- Installer: goose downloads the new installer, verifies its signature and opens the setup wizard when you click
Install & Restart. Follow the wizard to complete the update. - Portable ZIP: goose downloads the new ZIP and replaces the unzipped folder with it. If the automatic update fails, use the manual update steps below.
Not sure which you have? The installer version is listed under Installed apps in Windows Settings; the portable ZIP is not.
To automatically download and install updates:
- Click the button in the top-left to open the sidebar
- Click
Settingsin the sidebar - Click
App - Scroll down to the
Updatessection:- 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
- Click
Install & Restartto 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:
-
Click one of the buttons below to download goose Desktop for Windows:
- Quit goose Desktop
- Run the downloaded installer, or unzip the downloaded zip file in place of your existing folder
- Launch goose Desktop
Switching from the portable ZIP to the installer
Your settings and sessions are stored in %APPDATA%\Block\goose, outside the unzipped folder, so they carry over to the installed copy.
- Quit goose Desktop.
- Download and run the installer, then launch goose Desktop from the Start Menu.
- Delete the old unzipped folder and any shortcuts that point to it.
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
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.