diff --git a/docs/cli.mdx b/docs/cli.mdx index ca03a5227..5ff2995ca 100644 --- a/docs/cli.mdx +++ b/docs/cli.mdx @@ -21,6 +21,7 @@ Configure and launch external applications to use Ollama models. This provides a - **OpenCode** - Open-source coding assistant - **Claude Code** - Anthropic's agentic coding tool - **Codex** - OpenAI's coding assistant +- **VS Code** - Microsoft's IDE with built-in AI chat - **Droid** - Factory's AI coding agent #### Examples diff --git a/docs/docs.json b/docs/docs.json index 3f2a14c27..921992495 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -127,6 +127,7 @@ }, { "group": "IDEs & Editors", + "expanded": true, "pages": [ "/integrations/cline", "/integrations/jetbrains", diff --git a/docs/images/local.png b/docs/images/local.png new file mode 100644 index 000000000..69f79408e Binary files /dev/null and b/docs/images/local.png differ diff --git a/docs/images/vscode-add-ollama.png b/docs/images/vscode-add-ollama.png new file mode 100644 index 000000000..73fe4178d Binary files /dev/null and b/docs/images/vscode-add-ollama.png differ diff --git a/docs/images/vscode-model-options.png b/docs/images/vscode-model-options.png deleted file mode 100644 index b1cca5d08..000000000 Binary files a/docs/images/vscode-model-options.png and /dev/null differ diff --git a/docs/images/vscode-models.png b/docs/images/vscode-models.png deleted file mode 100644 index af250eac6..000000000 Binary files a/docs/images/vscode-models.png and /dev/null differ diff --git a/docs/images/vscode-other-models.png b/docs/images/vscode-other-models.png new file mode 100644 index 000000000..9b2b69a14 Binary files /dev/null and b/docs/images/vscode-other-models.png differ diff --git a/docs/images/vscode-unhide.png b/docs/images/vscode-unhide.png new file mode 100644 index 000000000..9f71fbdb9 Binary files /dev/null and b/docs/images/vscode-unhide.png differ diff --git a/docs/images/vscode.png b/docs/images/vscode.png new file mode 100644 index 000000000..fa2ef2366 Binary files /dev/null and b/docs/images/vscode.png differ diff --git a/docs/integrations/vscode.mdx b/docs/integrations/vscode.mdx index c04059b6f..63e58d749 100644 --- a/docs/integrations/vscode.mdx +++ b/docs/integrations/vscode.mdx @@ -2,33 +2,84 @@ title: VS Code --- -## Install +VS Code includes built-in AI chat through GitHub Copilot Chat. Ollama models can be used directly in the Copilot Chat model picker. -Install [VS Code](https://code.visualstudio.com/download). -## Usage with Ollama +![VS Code with Ollama](/images/vscode.png) -1. Open Copilot side bar found in top right window + +## Prerequisites + +- Ollama v0.18.3+ +- [VS Code 1.113+](https://code.visualstudio.com/download) +- [GitHub Copilot Chat extension 0.41.0+](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) + + VS Code requires you to be logged in to use its model selector, even for custom models. This doesn't require a paid GitHub Copilot account; GitHub Copilot Free will enable model selection for custom models. + +## Quick setup + +```shell +ollama launch vscode +``` + +Recommended models will be shown after running the command. See the latest models at [ollama.com](https://ollama.com/search?c=tools). + +Make sure **Local** is selected at the bottom of the Copilot Chat panel to use your Ollama models. +
+ Ollama Local Models +
+ + +## Run directly with a model + +```shell +ollama launch vscode --model qwen3.5:cloud +``` +Cloud models are also available at [ollama.com](https://ollama.com/search?c=cloud). + +## Manual setup + +To configure Ollama manually without `ollama launch`: + +1. Open the **Copilot Chat** side bar from the top right corner
VS Code chat Sidebar
-2. Select the model dropdown > **Manage models** +2. Click the **settings gear icon** () to bring up the Language Models window
VS Code model picker
-3. Enter **Ollama** under **Provider Dropdown** and select desired models (e.g `qwen3, qwen3-coder:480b-cloud`) +3. Click **Add Models** and select **Ollama** to load all your Ollama models into VS Code
VS Code model options dropdown +
+ +4. Click the **Unhide** button in the model picker to show your Ollama models +
+ VS Code unhide models button