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 reqsFull 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 depsFull Docs

Automatically detects your project type and installs all dependencies.

6 flags • 6 examples

azd app addFull Docs

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

2 flags • 5 examples

azd app runFull Docs

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

8 flags • 9 examples

azd app startFull Docs

Start stopped services.

2 flags • 4 examples

azd app stopFull Docs

Stop running services, execute lifecycle hooks, and tear down the app.

0 flags • 2 examples

azd app restartFull Docs

Restart services.

3 flags • 4 examples

azd app healthFull Docs

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

19 flags • 9 examples

azd app logsFull Docs

View logs from running services with filtering and follow support.

13 flags • 10 examples

azd app infoFull Docs

Show comprehensive information about running services.

2 flags • 4 examples

azd app testFull 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 completionFull Docs

Generate shell autocompletion scripts for `azd app`.

1 flags • 4 examples

azd app initFull Docs

Scans your project to detect services, languages, frameworks, and infrastructure dependencies, then generates or enriches `azure.yaml` with all the settings needed for `azd app run`.

2 flags • 4 examples

azd app mcpFull 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 notificationsFull Docs

View and manage notifications for service state changes and events.

0 flags • 10 examples

azd app versionFull 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 →