# Updating goose

> The goose CLI and desktop apps are under active and continuous development.

- 网址：https://funcoding.ai/agents/goose/guides/updating-goose/
- 来源：goose 官方文档原文（英文），Apache-2.0 许可，同步于 2026-10-11
- 官方原文：https://goose-docs.ai/docs/guides/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:

```sh
goose update
```

Additional [options](https://funcoding.ai/agents/goose/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](https://funcoding.ai/agents/goose/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
```

**Linux**

**goose Desktop**

Update goose to the latest stable version.

**To manually download and install updates:**
1. 

#### 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:

```sh
goose update
```

Additional [options](https://funcoding.ai/agents/goose/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](https://funcoding.ai/agents/goose/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
```

**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:

 ```sh
 goose update
 ```

 Additional [options](https://funcoding.ai/agents/goose/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](https://funcoding.ai/agents/goose/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>

<div class="callout callout-note">

**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](https://funcoding.ai/agents/goose/tutorials/cicd/) for a complete example and usage details.

</div>