Skip to main content
plugin

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

Install into GitHub Copilot · Command from the source All methods and platforms ↓
copilot plugin install azure-resources-query@awesome-copilot
Open on GitHub

What 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-copilot

Step 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 Azure Resources Query panel with synthetic Function App results and Add to chat.](docs/resources-fixture.png)

*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

Similar plugins

All plugins for Cloud: AWS, Azure, GCP →

From the same set7

Project sponsors

Companies that keep this analytics open