diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md index 80ca0408a0..015185d057 100644 --- a/documentation/docs/getting-started/installation.md +++ b/documentation/docs/getting-started/installation.md @@ -3,16 +3,14 @@ sidebar_position: 1 --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -import SupportedEnvironments from '@site/src/components/SupportedEnvironments'; import RateLimits from '@site/src/components/RateLimits'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons'; import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons'; +import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstallButtons'; # Install Goose - - Choose to install Goose on CLI and/or Desktop: @@ -82,18 +80,46 @@ import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopIns - Run the following command to install the Goose CLI on Linux: + Choose to install Goose on CLI and/or Desktop: - ```sh - curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash - ``` - This script will fetch the latest version of Goose and set it up on your system. + + + Install Goose Desktop directly from the browser. + +

Install via Download

+ - If you'd like to install without interactive configuration, disable `CONFIGURE`: +
+ 1. Extract the downloaded tar.bz2 file. + 2. Run the executable file to launch the Goose Desktop application. - ```sh - curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash - ``` + :::tip Updating Goose + It's best to keep Goose updated by periodically running the installation steps again. + ::: +
+ + + Run the following command to install the Goose CLI on Linux: + + ```sh + curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash + ``` + This script will fetch the latest version of Goose and set it up on your system. + + 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 + ``` + + :::tip Updating Goose + It's best to keep Goose updated. To update Goose, run: + ```sh + goose update + ``` + ::: + + diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md index 32801aad0e..8b9cc0eb43 100644 --- a/documentation/docs/guides/updating-goose.md +++ b/documentation/docs/guides/updating-goose.md @@ -8,6 +8,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; 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. @@ -58,6 +59,52 @@ The Goose CLI and desktop apps are under active and continuous development. To g + + + + :::info + To update Goose to the latest stable version, reinstall using the instructions below + ::: +
+ 1. + 2. Extract the downloaded tar.bz2 file. + 3. Run the executable file to launch the Goose Desktop application. + 4. Overwrite the existing Goose application with the new version. + 5. Run the executable file to launch the Goose Desktop application. +
+ + + 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/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash + ``` + + To check your current Goose version, use the following command: + + ```sh + goose --version + ``` + + + + @@ -72,6 +119,63 @@ The Goose CLI and desktop apps are under active and continuous development. To g 5. Run the executable file to launch the Goose Desktop application. + + 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:** + + ```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 within 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 + ``` + \ No newline at end of file diff --git a/documentation/docs/quickstart.md b/documentation/docs/quickstart.md index 0c158081d4..3da0d3522a 100644 --- a/documentation/docs/quickstart.md +++ b/documentation/docs/quickstart.md @@ -6,17 +6,14 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Link from "@docusaurus/Link"; import { IconDownload } from "@site/src/components/icons/download"; -import SupportedEnvironments from '@site/src/components/SupportedEnvironments'; import RateLimits from '@site/src/components/RateLimits'; import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons'; import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons'; +import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstallButtons'; # Goose in 5 minutes - - - Goose is an open source AI agent that supercharges your software development by automating coding tasks. This quick tutorial will guide you through getting started with Goose! @@ -47,7 +44,11 @@ Goose is an open source AI agent that supercharges your software development by - Desktop version is currently unavailable for Linux. + +
+ 1. Extract the downloaded tar.bz2 file. + 2. Run the executable file to launch the Goose Desktop application. +
Run the following command to install the Goose CLI on Linux: diff --git a/documentation/src/components/LinuxDesktopInstallButtons.js b/documentation/src/components/LinuxDesktopInstallButtons.js new file mode 100644 index 0000000000..47121c2b2d --- /dev/null +++ b/documentation/src/components/LinuxDesktopInstallButtons.js @@ -0,0 +1,32 @@ +import Link from "@docusaurus/Link"; +import { IconDownload } from "@site/src/components/icons/download"; + +const LinuxDesktopInstallButtons = () => { + return ( +
+

To download Goose Desktop for Linux, choose the buttons below:

+
+ + Linux x86_64 + + + Linux ARM64 + + + RPM Package + +
+
+ ); +}; + +export default LinuxDesktopInstallButtons; \ No newline at end of file