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
`--cwd`	`-C`	Sets the current working directory

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.

6 flags • 6 examples

azd app add Full Docs

Add a well-known container service to your azure.yaml configuration.

2 flags • 5 examples

azd app run Full Docs

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

8 flags • 9 examples

azd app start Full Docs

Start stopped services.

2 flags • 4 examples

azd app stop Full Docs

Stop running services.

3 flags • 4 examples

azd app restart Full Docs

Restart services.

3 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.

13 flags • 10 examples

azd app info Full Docs

Show comprehensive information about running services.

2 flags • 4 examples

azd app test Full Docs

Run tests for all services in your application with support for different test types and aggregated code coverage.

17 flags • 10 examples

azd app completion Full Docs

Generate shell autocompletion scripts for `azd app`.

1 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

# 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 →