Files
2026-05-18 18:38:14 +00:00

169 lines
5.3 KiB
Markdown

---
sidebar_position: 6
title: Updating goose
sidebar_label: 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.
<Tabs>
<TabItem value="mac" label="macOS" default>
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
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>
</TabItem>
<TabItem value="linux" label="Linux">
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
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>
</TabItem>
<TabItem value="windows" label="Windows">
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
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>
</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](/docs/tutorials/cicd) for a complete example and usage details.
:::