microsoft/vscode-copilotstudio

microsoft/vscode-copilotstudio

Description: VS Code Extension for Copilot Studio

Language: C#

License: MIT

Stars: 95

Forks: 13

Open issues: 42

Created: 2025-03-20T19:53:16Z

Pushed: 2026-06-10T23:07:11Z

Default branch: main

Fork: no

Archived: no

README:

Copilot Studio Extension for Visual Studio Code

> [!IMPORTANT] > This repository contains the full source code for the Copilot Studio VS Code > extension. The build currently requires internal NuGet packages and is not > externally reproducible yet. We are replacing the internal dependency > (Dataverse authoring SDK) with PAC CLI > delegation, which will make the build fully self-contained with public > packages. See [CONTRIBUTING.md](CONTRIBUTING.md) for details and current > status.

The Copilot Studio extension for Visual Studio Code is designed to enhance the development experience of Microsoft Copilot Studio agents. It provides language support, IntelliSense code completion and suggestions, and authoring capabilities for Copilot Studio agent components.

After installation, the extension prompts you to sign in to Copilot Studio. It can then show you a list of the agents associated with your environment. Clone an agent to see its editable components, including knowledge sources, actions, topics, and triggers.

Connect to Copilot Studio for the first time

1. Select the Copilot Studio icon in the primary side bar of Visual Studio Code. The extension asks for your permission to sign in.

1. Select Allow, and sign in with the appropriate credentials for your Copilot Studio environment.

Clone an agent

1. (Optional) Open the desired agent in Copilot Studio and copy its URL from your browser's address bar.

1. In the Copilot Studio panel of Visual Studio Code, select Clone agent.

1. Select your agent (marked with "from clipboard" if you already copied the URL); otherwise, select the desired environment and then select the desired agent. The extension prompts you to select a folder to hold your agent's files (similar to a local repository).

!Screenshot of the agent/environment picker of the Copilot Studio extension in Visual Studio code

1. Select the desired folder.

Edit your agent

To edit any component, open the corresponding file and make the desired changes. Since Visual Studio Code natively supports YAML files, the Copilot Studio extension supports IntelliSense code completion and can provide guided tips.

!Screenshot of an agent topic open for editing with the Copilot Studio extension in Visual Studio code

Sync your changes

The Copilot Studio extension keeps your local workspace in sync with your agent. Use the sync commands in the Agent Changes view to manage changes between your local files and your Copilot Studio agent.

• Preview changes — See what's different between your local workspace and the agent in Copilot Studio, without modifying any files.
• Get changes — Download the latest changes from your Copilot Studio agent into your local workspace.
• Apply changes — Upload your local edits to your Copilot Studio agent.

When you apply changes, they are saved directly to your agent's environment. This is a _live editing_ experience—your agent is updated immediately.

Repository Structure

src/
LanguageServers/ # .NET language server (C#)
CLaSP/ # Common Language Server Protocol framework
PowerPlatformLS/ # Language server solution (11 projects)
vscode-extensions/ # VS Code extension (TypeScript)
microsoft-powerplatformlang-extension/ # Extension entry point
shared/ # Shared TypeScript modules
docs/ # Architecture documentation
assets/ # Shared assets (BotSchema.json)
build/ # Build infrastructure

For architecture details, see the [docs/](docs/) folder.

Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for build prerequisites, current build state, and contribution guidelines.

Reporting Issues

To help us resolve problems more efficiently, please use the custom issue reporting command built into this extension. It automatically includes helpful diagnostic information like your session ID.

✅ Recommended: use the custom Help: Copilot Studio: Report Issue command

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS) 2. Type and select: Help: Copilot Studio: Report Issue

3. A form will appear with a pre-filled Session ID, fill out the form and submit. This ensures we receive context to investigate your issue quickly.

⚠️ Avoid using the built-in Help: Report Issue...

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details.

License

[MIT](LICENSE)