From d68366988c7004e4badaa84b9f0e804493353dd6 Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Tue, 23 Dec 2025 17:27:38 -0800 Subject: [PATCH 1/3] readd goose for vs code --- documentation/docs/experimental/index.md | 5 ++ documentation/docs/experimental/ollama.md | 8 +- .../docs/experimental/vs-code-extension.md | 77 ++++++++++--------- documentation/docs/guides/acp-clients.md | 8 +- 4 files changed, 60 insertions(+), 38 deletions(-) diff --git a/documentation/docs/experimental/index.md b/documentation/docs/experimental/index.md index 545e00c6559f..74044222353b 100644 --- a/documentation/docs/experimental/index.md +++ b/documentation/docs/experimental/index.md @@ -29,6 +29,11 @@ The list of experimental features may change as goose development progresses. So description="Enable remote access to goose Desktop from the goose AI mobile app via secure tunneling." link="/docs/experimental/mobile-access" /> + - +Use these steps to install the [goose for VS Code extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-goose) in VS Code. 1. Open VS Code -2. Open the Extensions view in VS Code: - - Windows/Linux: `Ctrl+Shift+X` +2. Open the Extensions marketplace in VS Code: - macOS: `Cmd+Shift+X` + - Windows/Linux: `Ctrl+Shift+X` - Or use: View → Extensions 3. Search for `VS Code goose` -4. Click Install on [VS Code goose](https://marketplace.visualstudio.com/items?itemName=block.vscode-goose) by Block +4. On the `goose for VS Code` page, click the `Install` button 5. Restart VS Code if prompted -6. Open the goose: Chat side panel to start a new conversation or view conversation history +6. Click the icon in the Activity Bar to open the side panel and start chatting with goose - - +## Share Context with goose -Not available via CLI. +There are two ways to provide context to goose. - - +### Send Selected Code -:::tip -You can ask goose about a particular file or code block by: -- Selecting the code you want to discuss -- Right-clicking and choosing "Ask goose about this code" -- The code will appear as a reference chip above the chat input -::: +1. Select the code you want to discuss in your editor +2. Send the selection to goose: + - macOS: `Cmd+Shift+G` + - Windows/Linux: `Ctrl+Shift+G` + - Right-click and choose `Send to goose` + +The selected code will appear as a context chip above the chat input. + +### Attach Files with @ Mentions + +1. Type `@` in the chat input and start typing the file name +2. Select the file: + - Use the arrow keys (↑/↓) to select the file and press `Enter` + - Use your mouse to select the file + +The attached file will appear as a context chip above the chat input. ## Example Usage -The goose VS Code Extension connects directly to your editor, letting you manage files, projects, and workflows with AI. It includes the following features: +The goose for VS Code extension connects directly to your editor, letting you manage files, projects, and workflows with AI. It includes the following features: -- Interactive chat UI -- Access to goose's AI capabilities directly within VS Code -- Unified session switching -- Code referencing with visual chips in the chat UI -- Quick actions for common coding tasks +- Interactive chat UI with streaming responses +- Access to goose's AI capabilities and enabled extensions +- Session management with history replay +- Context sharing and visual context chips in the chat UI - Clipboard tools to copy code snippets/responses for easy sharing - ### goose Prompt ``` @@ -88,4 +95,4 @@ I also included helpful information about the hot-reloading feature and the loca Is there anything else you'd like me to add or modify in the contributing guide? -``` \ No newline at end of file +``` diff --git a/documentation/docs/guides/acp-clients.md b/documentation/docs/guides/acp-clients.md index 95ac7cd9616d..18af295e14d8 100644 --- a/documentation/docs/guides/acp-clients.md +++ b/documentation/docs/guides/acp-clients.md @@ -20,7 +20,11 @@ The client manages the goose lifecycle automatically, including: - **Multiple Sessions**: The client manages multiple concurrent goose conversations simultaneously :::info Session Persistence -ACP sessions are saved to goose's session history where you can access and manage them using goose. However, these sessions aren't persisted in ACP clients, so you'll need to start a new conversation each time you restart the client. +ACP sessions are saved to goose's session history where you can access and manage them using goose. Access to session history in ACP clients might vary. +::: + +:::tip Reference Implementation +The [goose for VS Code](/docs/experimental/vs-code-extension) extension uses ACP to communicate with goose. See the [vscode-goose](https://github.com/block/vscode-goose) repository for implementation details. ::: ## Setup in ACP Clients @@ -37,7 +41,7 @@ Ensure you have both Zed and goose CLI installed: - **Zed**: Download from [zed.dev](https://zed.dev/) - **goose CLI**: Follow the [installation guide](/docs/getting-started/installation) - - ACP support works best with version 1.14.2 or later - check with `goose --version`. + - ACP support works best with version 1.16.0 or later - check with `goose --version`. - Temporarily run `goose acp` to test that ACP support is working: From 765ca62a28d7307dfbd1c5a1102cf0922691345b Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Tue, 23 Dec 2025 17:37:10 -0800 Subject: [PATCH 2/3] Update documentation/docs/experimental/vs-code-extension.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- documentation/docs/experimental/vs-code-extension.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/documentation/docs/experimental/vs-code-extension.md b/documentation/docs/experimental/vs-code-extension.md index e2b95a0ac9da..40c22d599e08 100644 --- a/documentation/docs/experimental/vs-code-extension.md +++ b/documentation/docs/experimental/vs-code-extension.md @@ -4,8 +4,6 @@ sidebar_label: VS Code Extension sidebar_position: 4 --- -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; import IconGoose from "@site/src/components/icons/goose"; The [goose for VS Code extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-goose) lets you interact with goose directly within VS Code. From 4a82b26af5ed4257143b1cde54a8073a22022d43 Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Mon, 29 Dec 2025 08:59:02 -0800 Subject: [PATCH 3/3] fix install instructions --- .../docs/experimental/vs-code-extension.md | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/documentation/docs/experimental/vs-code-extension.md b/documentation/docs/experimental/vs-code-extension.md index 40c22d599e08..bfb44d702d59 100644 --- a/documentation/docs/experimental/vs-code-extension.md +++ b/documentation/docs/experimental/vs-code-extension.md @@ -21,17 +21,11 @@ The extension uses the [Agent Client Protocol (ACP)](/docs/guides/acp-clients) t - [goose CLI](/docs/getting-started/installation) version 1.16.0 or higher ::: -Use these steps to install the [goose for VS Code extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-goose) in VS Code. - -1. Open VS Code -2. Open the Extensions marketplace in VS Code: - - macOS: `Cmd+Shift+X` - - Windows/Linux: `Ctrl+Shift+X` - - Or use: View → Extensions -3. Search for `VS Code goose` -4. On the `goose for VS Code` page, click the `Install` button -5. Restart VS Code if prompted -6. Click the icon in the Activity Bar to open the side panel and start chatting with goose +1. Go to [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=block.vscode-goose) +2. Click `Install` +3. On the popup window, click `Open Visual Studio Code` +4. In Visual Studio Code, click `Install` +5. Click the icon in the Activity Bar to open the side panel and start chatting with goose ## Share Context with goose