{"id":483,"date":"2026-06-16T10:00:00","date_gmt":"2026-06-16T17:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/aspire\/?p=483"},"modified":"2026-06-15T11:39:58","modified_gmt":"2026-06-15T18:39:58","slug":"aspire-vscode-extension-13-4","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/aspire\/aspire-vscode-extension-13-4\/","title":{"rendered":"Aspire in VS Code: the 13.4 developer loop"},"content":{"rendered":"

Visual Studio Code consistently ranks as the most popular<\/a> IDE for developers, and its flexibility and extension marketplace make it possible for developers using any technology or language to build and debug their applications. In 2026, we’ve brought Aspire support to VS Code, providing an integrated experience for developing, running, and deploying AppHosts inside the IDE you already use.<\/p>\n

The Aspire VS Code extension hooks into the Aspire CLI<\/a>. To use it, ensure that the Aspire CLI is installed and available on your PATH<\/code>, or run the > Aspire: Install Aspire CLI (stable)<\/code> command inside VS Code after extension installation.<\/p>\n

Install the Aspire VS Code extension<\/a><\/div><\/p>\n

Come as you are<\/h2>\n

To create a new Aspire app, you can use the > Aspire: New Aspire project<\/code> command palette command, which will scaffold your application after prompting for a template type, app location, and whether you want to install AI skills that teach coding models how to effectively develop with Aspire.<\/p>\n

\"VS<\/p>\n

Aspirify an existing app with the > Aspire: Initialize Aspire in an existing codebase<\/code> command or open a repo that already has an AppHost.<\/p>\n

Debug (almost) all your resources<\/h2>\n

Aspire in Visual Studio Code natively supports debugging for both C# and TypeScript AppHosts.<\/p>\n

When launching an AppHost with the Aspire debugger, Aspire will also orchestrate and provide debugging support for C#, TS\/JS, Python, and Go resources. You can even use WithBrowserDebugger<\/a> to automatically launch a debug browser with frontend source after the resource is healthy. Throughout the rest of 2026, we will be expanding debugger support to include additional languages like Java.<\/p>\n

Set up debugging<\/h3>\n

To set up a launch configuration for the first time, run the > Aspire: Configure launch.json file<\/code> command. The generated launch config can be as small as:<\/p>\n

{\n  \"type\": \"aspire\",\n  \"request\": \"launch\",\n  \"name\": \"Aspire: Launch default AppHost\",\n  \"program\": \"${workspaceFolder}\"\n}<\/code><\/pre>\n
That one debug profile is enough for the extension to build the AppHost, start resources, attach supported debuggers, and, if configured, open the Aspire dashboard. If you want more control, the same type: \"aspire\"<\/code> launch config also supports deploy<\/code>, publish<\/code>, and do<\/code> (run a pipeline step, must be paired with the step<\/code> property) commands:<\/p>\n
{\n  \"type\": \"aspire\",\n  \"request\": \"launch\",\n  \"name\": \"Aspire: Deploy AppHost\",\n  \"program\": \"${workspaceFolder}\",\n  \"command\": \"deploy\",\n  \"env\": {\n    \"ASPIRE_ENVIRONMENT\": \"Development\",\n    \"MY_ENVIRONMENT_VARIABLE\": \"Hello\"\n  },\n  \"args\": [\"--non-interactive\"]\n}<\/code><\/pre>\n
By using the deploy<\/code> and do<\/code> commands, custom publishers and pipeline steps can be debugged from the same VS Code launch path, allowing you full visibility into what your pipeline is producing and how.<\/p>\n
You can pass per-language debugger settings through the debuggers<\/code> property.<\/p>\n
Hitting F5<\/h3>\n
Most Aspire apps have multiple processes. A normal app might have a C# API, a React frontend, a Python worker, a browser target, a database container, and now maybe a Go service too. The extension turns the AppHost model into the right VS Code debug sessions.<\/p>\n
\"VS<\/p>\n
The documented support includes C#\/.NET, Python, Node.js, browser apps, and Azure Functions. New in Aspire 13.4, we have also added first-party Go hosting with VS Code debugger support through dlv-dap<\/code>.<\/p>\n
Put resource state next to the AppHost code<\/h2>\n
The Aspire extension’s most noticeable editor addition is showing live resource state in your AppHost file editor. Important state and actions are available at a glance, including resource health, health check status, and available commands. This same information is available elsewhere in VS Code through the Aspire panel.<\/p>\n
When the AppHost is running, CodeLens appears above supported resource declarations. Note that you don’t have to start an AppHost inside VS Code to see this UI; CLI-managed runs using aspire run<\/code> or aspire start<\/code> are also shown.<\/p>\n
\"Aspire<\/p>\n
The gutter also gets health-aware icons. They use different shapes and icons, so you can easily and quickly identify any issues or anomalies.<\/p>\n
There are two new AppHost-level CodeLens actions worth calling out in 13.4: Open Dashboard<\/strong> and View Logs<\/strong>. They sit by the builder statement, so when you are already looking at the AppHost you can jump to the Aspire dashboard or AppHost logs without switching to the Aspire panel first or needing to execute a terminal command.<\/p>\n
The Aspire panel is useful even before you start debugging<\/h2>\n
Currently, most Aspire work still eventually lands in the Aspire Dashboard<\/a>: resources, endpoints, logs, traces, metrics, and commands in one place. And the Aspire Dashboard is great!<\/p>\n
But one of our goals in 13.4 has been tightening the developer loop, so with the Aspire panel, common actions can be done directly in VS Code, eliminating the need to navigate away from your IDE at all. Health check status, resource type, clickable commands, resource endpoints, and dashboard links are all shown in the panel.<\/p>\n
<\/i>Note<\/strong><\/p>The Aspire panel has two modes: workspace and global. Workspace view shows running and idle AppHosts from inside the open workspace, while global view shows all running AppHosts on your machine.<\/div><\/p>\n
\"Aspire<\/p>\n
Beginning in Aspire 13.4, commands can declare typed arguments, labels, descriptions, defaults, choices, validation, and secret inputs. The extension uses VS Code prompts for those inputs, then sends the command through the Aspire CLI. Learn more<\/a> about custom Aspire commands and arguments.<\/p>\n
Dashboard stays one click away<\/h2>\n
Beginning mid-June, the Aspire dashboard will no longer open automatically when you start an AppHost from VS Code. However, you can still open the dashboard via the Aspire panel, AppHost editor, or command palette. The old behavior can be restored by setting aspire.enableAspireDashboardAutoLaunch<\/code> to true and the aspire.dashboardBrowser<\/code> VS Code setting to a value that will open the dashboard after launch:<\/p>\n