CLI Reference

Complete reference for all azd app commands and flags.

Global Flags

These flags are available for all commands:

Flag Short Description
--output -o Output format (default, json)
--debug - Enable debug logging
--structured-logs - Enable structured JSON logging to stderr

Commands

azd app reqs Full Docs

Verifies that all required tools are installed and optionally checks if they are running. Can also auto-generate requirements from your project.

5 flags • 6 examples
azd app deps Full Docs

Automatically detects your project type and installs all dependencies.

4 flags • 5 examples
azd app run Full Docs

Starts your development environment based on project type with support for multi-service orchestration.

6 flags • 8 examples
azd app start Full Docs

Start stopped services.

2 flags • 4 examples
azd app stop Full Docs

Stop running services.

2 flags • 4 examples
azd app restart Full Docs

Restart services.

2 flags • 4 examples
azd app health Full Docs

Monitor the health status of running services with production-grade reliability and observability features.

19 flags • 9 examples
azd app logs Full Docs

View logs from running services with filtering and follow support.

11 flags • 10 examples
azd app info Full Docs

Show comprehensive information about running services.

2 flags • 4 examples
azd app mcp Full Docs

Model Context Protocol (MCP) server for AI assistant integration. Enables AI assistants like Claude Desktop and GitHub Copilot to interact with your azd app projects.

0 flags • 3 examples
azd app notifications Full Docs

View and manage notifications for service state changes and events.

0 flags • 10 examples
azd app version Full Docs

Show version information for the azd app extension.

0 flags • 2 examples

Quick Reference

Terminal window
# Check prerequisites
azd app reqs


# Install dependencies
azd app deps


# Start development environment
azd app run


# Monitor service health
azd app health --stream


# View logs
azd app logs --follow


# Show running services
azd app info


# Start MCP server for AI debugging
azd app mcp serve

Environment Variables

When running through azd app <command>, these Azure environment variables are automatically available:

Variable Description
AZURE_SUBSCRIPTION_ID Current Azure subscription
AZURE_RESOURCE_GROUP_NAME Target resource group
AZURE_ENV_NAME Environment name
AZURE_LOCATION Azure region
🤖

AI-Powered Debugging with MCP

The azd app mcp command enables AI assistants like GitHub Copilot to interact with your running services.

Learn about MCP integration →