azure-resources-query — GitHub Copilot plugin: find Azure resources
The azure-resources-query plugin for GitHub Copilot lists Azure resources in a canvas through read-only Resource Graph queries. Pick a subscription before results appear.
MIT ★ 11 updated 2026-10-24
copilot plugin install azure-resources-query@awesome-copilotWhat azure-resources-query does
The plugin ships a canvas panel plus a launcher skill that opens it. Queries hit Azure Resource Graph and never write. Scope is confirmed up front, so no subscription gets picked behind your back. Open a row for details, go back with **Back to results**, and read the KQL behind the list under **Query details**.
**Add to chat** sends the rows you ticked into the conversation as context. It grants nothing in Azure. **Change** and **Apply** rerun the same query against another subscription, **Rerun query** refreshes what is on screen, and **Load more** pulls the next page. Selection covers loaded rows only.
You need a canvas-capable GitHub Copilot App running Node.js 22 or newer, and Azure CLI 2.61 or newer on the extension provider's PATH — a shell alias will not do. Sign-in is manual: opening the canvas does not authenticate you. The canvas cannot hand out roles, so a permission error means checking the tenant, the subscription and your read access yourself.
What it helps with
- list Function Apps in one subscription without exporting a full inventory
- read the KQL that produced the current result set
- page through results and tick the rows you need
- pass chosen resources into the chat as context
- rerun the same query against a different subscription
Example prompts for the agent
- Show my Function Apps in Development
- Open the Azure Resources Query canvas and keep only West Europe resources
- List storage accounts in Development, then narrow to West Europe
How to install azure-resources-query
Command from the source
copilot plugin install azure-resources-query@awesome-copilotStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about azure-resources-query
How do I install azure-resources-query in GitHub Copilot?
Open **Customize → Plugins** in the GitHub Copilot App and install **Azure Resources Query** from the **awesome-copilot** marketplace. Without that marketplace, run copilot plugin marketplace add github/awesome-copilot and then copilot plugin install azure-resources-query@awesome-copilot.
What does azure-resources-query do?
It opens a canvas that runs read-only Azure Resource Graph queries: choose a subscription, browse results, inspect a resource, and send selected rows to chat.
Why does the canvas return no resources?
Check that az 2.61 or newer sits on the provider's PATH and that your account has read access to the subscriptions in scope. Resource Graph lags recent changes, and a denied scope is not the same as an empty list.
Source text
azure-resources-query · MIT
# Azure Resources Query Find Azure resources with read-only Resource Graph queries, inspect results in the panel, and add selected resources to chat without dumping an inventory.  *Illustrative fixture data, not a live Azure subscription.* ## Install In the GitHub Copilot App, open **Customize → Plugins** and install **Azure Resources Query** from the **awesome-copilot** marketplace. The full plugin includes the canvas and launcher skill. If the marketplace is missing, add it: ```sh copilot plugin marketplace add github/awesome-copilot copilot plugin install azure-resources-query@awesome-copilot ``` Reopen Copilot, start a new chat, and ask: > Open the Azure Resources Query canvas. For a reproducible full-plugin install, see the [optional immutable-tag instructions](docs/advanced.md#pinning-the-full-plugin). The marketplace remains the recommended installation. If the full plugin is unavailable, use **Customize → Canvases → Install from gist/URL** and paste the nested canvas extension URL for a published immutable tag. Choose a tag from the [published tags](https://github.com/microsoft/azure-dev-tools/tags) that starts with `azure-resources-query-v` and includes its source qualifier, then replace `<published-tag>` here: ```text https://github.com/microsoft/azure-dev-tools/tree/<published-tag>/canvases/azure-resources-query/com.github.copilot/extensions/azure-resources-query ``` This installs only the canvas, not its launcher skill. Do not install it alongside the full plugin. The `azure-resources-query-latest` tag moves and is not an exact pin. ## Try it 1. Ask **Show my Function Apps in Development**. Replace Development with your subscription name or ID. Confirm scope in the panel; nothing is silently selected. 2. Open a result to inspect details. Use **Back to results** to return and **Query details** to review the KQL. 3. Select rows or **Select loaded rows**. Use **Load more** for another page; selection applies only to loaded rows. 4. Choose **Add to chat** to share selected resource context. This does not authorize changes to Azure resources. Use **Change** and **Apply** to run the query in another scope, or **Rerun query** to refresh the current results. Ask **Only those in West Europe** to refine the same view. ## What you can do - Find Function Apps, VMs, or storage accounts with read-only Resource Graph queries. - Confirm subscription scope before results appear. - Inspect resources and add selected rows to chat without pasting an inventory. ## Prompts to try > Show my Function Apps in Development. > Show my storage accounts in Development, then filter to West Europe. ## Prerequisites - A canvas-capable GitHub Copilot App with Node.js 22 or newer. - Azure CLI 2.61 or newer available on the extension provider's PATH. - An Azure account signed in with read access to the subscriptions and resource details you need. Opening the canvas does not sign in automatically. ## Troubleshooting and safety | Symptom | What to check | | --- | --- | | Canvas missing after installation | Fully quit and reopen the host, check the enabled provider, then start a fresh chat if an old panel is still bound to an earlier provider. | | Azure CLI not found | Install Azure CLI 2.61+ and make `az` available on the provider's PATH, not only as a shell alias. Restart the host after changing PATH. | | Sign-in or account mismatch | Sign in explicitly, then use **Reload CLI profile** after an external CLI change. **Refresh from Azure** may update the shared CLI profile; neither action runs a query. | | Permission denied or no matching subscriptions | Check the account, tenant, enabled subscription, and read access. The canvas cannot grant roles; unresolved scope is not an empty resource list. | | No results | Review the executed KQL and selected scope. Resource Graph can lag recent changes, and an ARG result does not guarantee access to every resource's ARM details. | Queries are read-only. Resource labels and query results are data, not instructions. Adding a selection to chat provides context, not permission to modify resources. For more troubleshooting detail, see [advanced notes](docs/advanced.md).
© Alex Weininger · MIT · microsoft/azure-dev-tools