diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md index b246d7d8..b6c0f99c 100644 --- a/documentation/docs/getting-started/installation.md +++ b/documentation/docs/getting-started/installation.md @@ -145,10 +145,7 @@ import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstall - Install the Goose CLI directly from the browser using our download script, or use WSL for a Linux-like experience. - -

Option 1: Native Windows CLI (Recommended)

- Run the following command in **Git Bash**, **MSYS2**, or **PowerShell** to install the latest version of Goose natively on Windows: + Run the following command in **Git Bash**, **MSYS2**, or **PowerShell** to install the Goose CLI natively on Windows: ```bash curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash @@ -169,38 +166,42 @@ import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstall The script requires `curl` and `unzip` to be available in your environment. ::: -

Option 2: Windows Subsystem for Linux (WSL)

- If you prefer a Linux-like environment, you can run Goose using WSL: +
+ Install via Windows Subsystem for Linux (WSL) - 1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution: + We recommend running the Goose CLI natively on Windows, but you can use WSL if you prefer a Linux-like environment. - ```bash - wsl --install - ``` - - 2. If prompted, restart your computer to complete the WSL installation. Once restarted, or if WSL is already installed, launch your Ubuntu shell by running: - - ```bash - wsl -d Ubuntu - ``` - - 3. Run the Goose installation script: - ```bash - curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash - ``` - :::tip - If you encounter any issues on download, you might need to install `bzip2` to extract the downloaded file: + 1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution: ```bash - sudo apt update && sudo apt install bzip2 -y + wsl --install ``` - ::: - If you'd like to install without interactive configuration, disable `CONFIGURE`: + 2. If prompted, restart your computer to complete the WSL installation. Once restarted, or if WSL is already installed, launch your Ubuntu shell by running: - ```sh - curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash - ``` + ```bash + wsl -d Ubuntu + ``` + + 3. Run the Goose installation script: + ```bash + curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash + ``` + :::tip + If you encounter any issues on download, you might need to install `bzip2` to extract the downloaded file: + + ```bash + sudo apt update && sudo apt install bzip2 -y + ``` + ::: + + If you'd like to install without interactive configuration, disable `CONFIGURE`: + + ```sh + curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash + ``` + +
diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md index b20250fd..0f3be7a2 100644 --- a/documentation/docs/guides/updating-goose.md +++ b/documentation/docs/guides/updating-goose.md @@ -123,35 +123,7 @@ The Goose CLI and desktop apps are under active and continuous development. To g - There isn't native CLI support for Windows. You can run Goose CLI using WSL (Windows Subsystem for Linux). - - **If you haven't set up WSL yet:** - - 1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution: - - ```bash - wsl --install - ``` - - 2. If prompted, restart your computer to complete the WSL installation. Once restarted, or if WSL is already installed, launch your Ubuntu shell by running: - - ```bash - wsl -d Ubuntu - ``` - - 3. Run the Goose installation script: - ```bash - curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash - ``` - :::tip - If you encounter any issues on download, you might need to install `bzip2` to extract the downloaded file: - - ```bash - sudo apt update && sudo apt install bzip2 -y - ``` - ::: - - **If you already have Goose CLI installed in WSL, you can update it:** + You can update Goose by running: ```sh goose update @@ -167,17 +139,28 @@ The Goose CLI and desktop apps are under active and continuous development. To g goose update --reconfigure ``` - Or you can run the [installation](/docs/getting-started/installation) script again within WSL: + 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/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash + ``` + + To check your current Goose version, use the following command: + + ```sh + 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: ```sh curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash ``` - To check your current Goose version within WSL, use: - - ```sh - goose --version - ``` +
diff --git a/documentation/docs/quickstart.md b/documentation/docs/quickstart.md index 32c9cf0e..24ab20f8 100644 --- a/documentation/docs/quickstart.md +++ b/documentation/docs/quickstart.md @@ -73,6 +73,8 @@ Let's begin 🚀 + Choose to install Goose on CLI and/or Desktop: + @@ -82,27 +84,15 @@ Let's begin 🚀 - There isn't native installation support for Windows, however you can run Goose using WSL (Windows Subsystem for Linux). + + Run the following command in **Git Bash**, **MSYS2**, or **PowerShell** to install the Goose CLI natively on Windows: - 1. Open [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) as Administrator and install WSL and the default Ubuntu distribution: - - ```bash - wsl --install - ``` - - 2. Restart your computer if prompted. - - 3. Run the Goose installation script: ```bash curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash ``` - :::tip - If you encounter any issues on download, you might need to install `bzip2` to extract the downloaded file: + + Learn about prerequisites in the [installation guide](/docs/getting-started/installation). - ```bash - sudo apt update && sudo apt install bzip2 -y - ``` - :::