azd extensions

A curated registry of Azure Developer CLI extensions

🌐 Live Site: jongio.github.io/azd-extensions

Extensions

Extension	Description	Latest
azd-app	Run Azure apps locally with auto-dependencies, real-time dashboard, and AI-powered debugging via MCP	v0.12.6
azd-copilot	AI-powered Azure development with 16 agents, 29 Azure skills, and MCP server integration	v0.1.9
azd-exec	Execute scripts with azd environment context, Azure credentials, and Key Vault integration	v0.3.8
azd-rest	Make authenticated REST API calls to Azure with automatic scope detection and token management	v0.1.1

Quick Start

1. Add This Registry

azd extension source add -n jongio -t url -l "https://jongio.github.io/azd-extensions/registry.json"

2. Install Extensions

# List available extensions
azd extension list --source jongio

# Install all extensions
azd extension install jongio.azd.app jongio.azd.copilot jongio.azd.exec jongio.azd.rest

# Or install individually
azd extension install jongio.azd.app
azd extension install jongio.azd.copilot
azd extension install jongio.azd.exec
azd extension install jongio.azd.rest

# View installed
azd extension list --installed

Usage Examples

azd-app

Run your entire app locally with one command — auto-dependencies, real-time dashboard, and AI-powered debugging:

# Start all services defined in azure.yaml
azd app run

# Check prerequisites are installed
azd app reqs

# Install dependencies for all services
azd app deps

# View logs (with optional follow)
azd app logs --follow

# Monitor service health
azd app health --stream

# Run tests with coverage
azd app test --coverage

# Show project info
azd app info

# Start the MCP server for AI debugging with GitHub Copilot
azd app mcp serve

azd-copilot

AI-powered Azure development assistant with agents, skills, and MCP server:

# Start the MCP server for GitHub Copilot integration
azd copilot mcp serve

# Use Azure agents for architecture, development, deployment, and more
azd copilot agent list

azd-rest

Make authenticated REST API calls to any Azure service — automatic OAuth scope detection, token management, and MCP server for AI integration:

# GET request to Azure Resource Manager
azd rest get "https://management.azure.com/subscriptions?api-version=2022-12-01"

# POST with a JSON body
azd rest post "https://management.azure.com/..." --body '{"key": "value"}'

# Use any HTTP method
azd rest put "https://..." --body @payload.json
azd rest patch "https://..." --body '{"update": true}'
azd rest delete "https://..."
azd rest head "https://..."

# Start the MCP server for AI-powered Azure API exploration
azd rest mcp serve

azd-exec

Run any script with full access to your azd environment variables, Azure credentials, and Key Vault secrets:

# Execute a script file with azd context
azd exec ./deploy.sh

# Execute an inline command
azd exec 'echo "Deploying to $AZURE_ENV_NAME"'

# Specify shell explicitly
azd exec --shell pwsh ./deploy.ps1

# Run in interactive mode
azd exec --interactive ./setup.sh

# Pass arguments to a script
azd exec ./build.sh --verbose --config release

# Key Vault secrets are resolved automatically from azd env references
azd exec ./deploy-with-secrets.sh

Development

Prerequisites

• Node.js 20+
• pnpm 9+

Setup

git clone https://github.com/jongio/azd-extensions.git
cd azd-extensions
pnpm install
pnpm dev

Commands

Command	Description
pnpm dev	Start dev server
pnpm build	Build for production
pnpm test	Run tests
pnpm test:coverage	Generate coverage report
pnpm lint	Lint code
pnpm type-check	TypeScript check
pnpm format	Format with Prettier

Tech Stack

Category	Technology
Framework	React 19 + TypeScript
Build	Vite 7
Styling	Tailwind CSS 4 + shadcn/ui
Animation	Motion
Testing	Vitest
CI/CD	GitHub Actions

Registry

The public/registry.json file is the extension source that azd reads. It auto-updates daily via GitHub Actions.

Manual Update

gh workflow run update-registry.yml

See CONTRIBUTING.md for details on adding extensions.

Project Structure

├── src/
│   ├── components/     # React components (Header, Footer, ExtensionCard, etc.)
│   │   ├── ui/        # shadcn/ui components
│   │   └── icons/     # Custom icons
│   ├── lib/           # Utilities
│   └── types/         # TypeScript types
├── public/
│   └── registry.json  # Extension registry (served to azd)
└── scripts/
    ├── update-registry.js    # Aggregates extension registries
    └── validate-registry.js  # Validates registry URLs and structure

Resources

• Azure Developer CLI Documentation
• azd Extension Framework
• Contributing Guide

License

MIT — see LICENSE

---

_{Built by Jon Gallant with React 19, Vite 7, and Tailwind CSS 4}