docs: auto download updates #6163
Conversation
|
There was a problem hiding this comment.
Pull request overview
This PR documents the auto-update flow for goose Desktop and standardizes the product name to lowercase "goose" across documentation. The changes add clear auto-update instructions through a new reusable component and update manual installation steps to be more concise and consistent.
Key changes:
- Added auto-update documentation with step-by-step instructions for all platforms (macOS, Linux, Windows)
- Standardized product naming to lowercase "goose" (instead of "Goose") across all documentation components and text
- Improved manual update instructions to be more concise and consistent with clearer calls to action
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| documentation/src/components/DesktopAutoUpdateSteps.js | New component providing step-by-step auto-update instructions for goose Desktop |
| documentation/docs/guides/updating-goose.md | Integrated auto-update steps and restructured manual update instructions for all platforms |
| documentation/docs/getting-started/installation.md | Updated tip text to link to the updating-goose guide instead of describing manual reinstallation |
| documentation/src/components/MacDesktopInstallButtons.js | Changed "Goose" to lowercase "goose" and revised button description text |
| documentation/src/components/WindowsDesktopInstallButtons.js | Changed "Goose" to lowercase "goose" and revised button description text |
| documentation/src/components/LinuxDesktopInstallButtons.js | Changed "Goose" to lowercase "goose" and revised button description text |
| documentation/src/components/recipe-card.tsx | Changed "Goose Desktop" and "Goose CLI Command" to lowercase "goose" |
| documentation/src/components/CLIExtensionInstructions.tsx | Changed "Goose" to lowercase "goose" in instruction text |
| documentation/src/components/ModelSelectionTip.js | Changed "Goose" to lowercase "goose" |
| documentation/src/components/OnboardingProviderSetup.js | Changed "Goose" to lowercase "goose" |
| documentation/src/components/RateLimits.js | Changed "Goose" to lowercase "goose" |
| documentation/src/components/SupportedEnvironments.js | Changed "Goose CLI" and "Goose Desktop" to lowercase "goose" |
| **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 |
There was a problem hiding this comment.
The Windows manual update instructions are incomplete compared to macOS and Linux. The instructions stop after "Run the executable file to launch the goose Desktop app" but don't clarify that this step should overwrite the existing installation. For consistency with macOS (which says "to overwrite your current version") and clarity, consider adding a note about overwriting the existing installation or restructuring steps to match the macOS pattern.
| 3. Run the executable file to launch the goose Desktop app | |
| 3. Replace your existing goose Desktop installation with the files from the unzipped folder (overwrite when prompted) | |
| 4. Run the executable file to launch the goose Desktop app |
There was a problem hiding this comment.
I believe you just run the executable on Windows
| 2. Download the DEB file | ||
| 3. Navigate to the directory where it is saved in a terminal | ||
| 4. Run `sudo dpkg -i (filename).deb` | ||
| 5. Launch goose from the app menu |
There was a problem hiding this comment.
Step 2 instructs to "Download the DEB file" after step 1 which already includes download buttons. This is redundant - clicking the buttons in step 1 downloads the file. Consider removing "2. Download the DEB file" or clarifying that users should download the DEB file specifically (as opposed to AppImage) by clicking the appropriate button in step 1.
| 2. Download the DEB file | |
| 3. Navigate to the directory where it is saved in a terminal | |
| 4. Run `sudo dpkg -i (filename).deb` | |
| 5. Launch goose from the app menu | |
| 2. Navigate to the directory where it is saved in a terminal | |
| 3. Run `sudo dpkg -i (filename).deb` | |
| 4. Launch goose from the app menu |
| <li>Scroll down to the <code>Updates</code> section: | ||
| <ul> | ||
| <li>Check if your current version is "up to date" or if a newer version is available</li> | ||
| <li>To automatically download the newer version, click <code>Check for Updates</code></li> |
There was a problem hiding this comment.
The instruction states "To automatically download the newer version, click Check for Updates", but this is misleading. The button checks for updates and downloads them if available - it's not solely for downloading. Consider rephrasing to "Click Check for Updates to download the newer version" or "Click Check for Updates to check and download the newer version if available".
| <li>To automatically download the newer version, click <code>Check for Updates</code></li> | |
| <li>Click <code>Check for Updates</code> to check for and download the newer version if available</li> |
There was a problem hiding this comment.
The check happens on app startup and you see "up to date" or "-> 1.16.1 available" when you view the App tab so I don't think we need to mention a second check here
* 'main' of github.com:block/goose: (28 commits) Clean PR preview sites from gh-pages branch history (#6161) fix: make goose reviewer less sycophantic (#6171) revert /reply to previous behavior (replacing session history) when full conversation provided (#6058) chore: manually update version (#6166) Integrate pricing with canonical model (#6130) Regenerate canonical models when release branch is created. (#6127) fix: use correct parameter name in read_module handler (#6148) docs: blog for code mode MCP (#6126) test: add ACP integration test (#6150) docs: auto download updates (#6163) fix: respect default_enabled value of platform extensions (#6159) docs: skills (#6062) fix: add conditional configuration for GOOSE_BIN_DIR in PATH (#5940) Update dependencies to help in Fedora packaging (#5835) fix: make goose reviewer less bad (#6154) docs: create/edit recipe button (#6145) fix(google): Fix 400 Bad Request error with Gemini 3 thought signatures (#6035) fix: we don't need to warn about tool count when in code mode (#6149) deps: upgrade agent-client-protocol to 0.9.0 (#6109) fix(providers): fix for gemini-cli on windows to work around cmd's multiline prompt limitations #5911 (#5966) ... # Conflicts: # ui/desktop/src/api/sdk.gen.ts # ui/desktop/src/hooks/useAgent.ts
Summary
This PR documents the auto update flow in goose Desktop:
Documentation updates:
documentation/docs/getting-started/installation.md:documentation/docs/guides/updating-goose.md:src/components/MacDesktopInstallButtons.js,src/components/LinuxDesktopInstallButtons.js, andsrc/components/WindowsDesktopInstallButtons.js:Lowercase "goose":
src/components/CLIExtensionInstructions.tsxsrc/components/ModelSelectionTip.jssrc/components/OnboardingProviderSetup.jssrc/components/RateLimits.jssrc/components/SupportedEnvironments.jssrc/components/recipe-card.tsxType of Change
AI Assistance
Testing
Some manual testing