goose/documentation/docs/guides/updating-goose.md

sidebar_position	title	sidebar_label
25	Updating goose	Updating goose

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import { DesktopAutoUpdateSteps } from '@site/src/components/DesktopAutoUpdateSteps'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons'; import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons'; import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstallButtons';

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.

Update goose to the latest stable version.

    <DesktopAutoUpdateSteps />
    
    **To manually download and install updates:**
    1. <MacDesktopInstallButtons/>
    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

  </TabItem>
  <TabItem value="cli" label="goose CLI">
    You can update goose by running:

    ```sh
    goose update
    ```

    Additional [options](/docs/guides/goose-cli-commands#update-options):
    
    ```sh
    # Update to latest canary (development) version
    goose update --canary

    # Update and reconfigure settings
    goose update --reconfigure
    ```

    Or you can run the [installation](/docs/getting-started/installation) script again:

    ```sh
    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:

    ```sh
    goose --version
    ```
  </TabItem>
</Tabs>

Update goose to the latest stable version.

    <DesktopAutoUpdateSteps />
    
    **To manually download and install updates:**
    1. <LinuxDesktopInstallButtons/>

    #### 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
  </TabItem>
  <TabItem value="cli" label="goose CLI">
    You can update goose by running:

    ```sh
    goose update
    ```

    Additional [options](/docs/guides/goose-cli-commands#update-options):
    
    ```sh
    # Update to latest canary (development) version
    goose update --canary

    # Update and reconfigure settings
    goose update --reconfigure
    ```

    Or you can run the [installation](/docs/getting-started/installation) script again:

    ```sh
    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:

    ```sh
    goose --version
    ```
  </TabItem>
</Tabs>

Update goose to the latest stable version.

    <DesktopAutoUpdateSteps />
    
    **To manually download and install updates:**
    1. <WindowsDesktopInstallButtons/>
    2. Unzip the downloaded zip file
    3. Run the executable file to launch the goose Desktop app
  </TabItem>
  <TabItem value="cli" label="goose CLI">
    You can update goose by running:

    ```sh
    goose update
    ```

    Additional [options](/docs/guides/goose-cli-commands#update-options):
    
    ```sh
    # Update to latest canary (development) version
    goose update --canary

    # Update and reconfigure settings
    goose update --reconfigure
    ```

    Or you can run the [installation](/docs/getting-started/installation) script again in **Git Bash**, **MSYS2**, or **PowerShell** to update the goose CLI natively on Windows:

    ```bash
    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:

    ```sh
    goose --version
    ```        

    <details>
    <summary>Update via Windows Subsystem for Linux (WSL)</summary>

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

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

   </details>
  </TabItem>
</Tabs>

:::info 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. :::