azd app

Run Azure Apps Locally

One command starts all services, manages dependencies, and provides real-time monitoring.

🌐 Visit the Website →

Interactive docs, guided tour, and live demos

📦 Part of azd Extensions →

Browse all Azure Developer CLI extensions by Jon Gallant

---

⚡ One-Command Start

Stop juggling terminals. Run azd app run and watch everything come alive.

azd app run

That's it. All your services start with dependencies resolved automatically.

Real-time dashboard showing all your running services

---

✨ Features

📊 Real-time Dashboard Monitor all your services in one place with live status updates and health checks. See what's running, what's failing, and where to click. 📝 Unified Logs Stream and filter logs from all services—both local and Azure. Search, highlight, and export with ease. Switch between local and cloud logs with a single click.

🔧 Auto Dependencies Automatically installs packages, creates virtual environments, and resolves requirements across Node.js, Python, .NET, and more. 🧪 Multi-Language Testing Run tests across all services with azd app test. Supports Node.js, Python, and .NET with unified coverage reporting. 🤖 AI-Powered Debugging Connect GitHub Copilot via MCP to analyze logs, diagnose issues, and suggest fixes. Your AI pair programmer that understands your running app. ❤️ Health Monitoring Automatic health checks with visual indicators. Know when services need attention before your users do. 🚀 Zero Configuration Works with your existing azure.yaml. No new config files, no complex setup. Just run and go.

---

🎯 Quick Start

1. Install Azure Developer CLI

Windows

winget install microsoft.azd

macOS

brew tap azure/azd && brew install azd

Linux

curl -fsSL https://aka.ms/install-azd.sh | bash

2. Install azd-app

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

# Install the extension
azd extension install jongio.azd.app

3. Initialize Your Project

cd your-project
azd app init

This scans your project, detects services/frameworks/dependencies, and generates azure.yaml.

4. Run Your App

azd app run

📚 Want the full walkthrough?

Start the Guided Tour →

---

🤖 AI Integration with MCP

azd app includes a Model Context Protocol (MCP) server that connects your running application to AI assistants like GitHub Copilot.

12 AI Tools Available:

• Observability: get_services, get_service_logs, get_service_errors, get_project_info
• Operations: run_services, stop_services, start_service, restart_service, install_dependencies
• Configuration: check_requirements, get_environment_variables, set_environment_variable

Ask Copilot things like:

• "Why is my API returning 500 errors?"
• "Restart the web service and show me the logs"
• "What environment variables are set for the API?"

Learn about MCP Integration →

---

📋 Supported Languages & Frameworks

Language	Package Managers	Frameworks
Node.js	npm, pnpm, yarn	Express, Next.js, React, Vue, Angular, Svelte, Astro, NestJS
Python	pip, uv, poetry	FastAPI, Flask, Django, Streamlit, Gradio
.NET	dotnet	ASP.NET Core, Aspire
Java	Maven, Gradle	Spring Boot, Quarkus
Go	go	-
Rust	cargo	-
PHP	composer	Laravel
Docker	docker	Docker Compose

---

📊 By the Numbers

12 MCP Tools	<5 min Setup	100% Open Source	Works with Copilot
Full AI integration	Quick start	MIT License	GitHub Copilot ready

---

📖 Documentation

🚀 Quick Start	Get running in under 5 minutes
🎯 Guided Tour	Step-by-step walkthrough
📚 CLI Reference	All commands documented
🤖 MCP Guide	AI integration setup

Configuration reference

azd app metadata prints a machine readable description of everything this extension can be configured with: the JSON Schema for the azure.yaml keys it reads at project and service scope, the JSON Schema for its user configuration, and every environment variable it defines. Those schemas are generated from the Go types at run time and the environment variable list is checked against the source tree by a test, so the output cannot drift from the implementation.

azd app metadata

---

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

---

🔗 azd Extensions

azd app is part of a suite of Azure Developer CLI extensions by Jon Gallant.

Extension	Description	Website
azd app	Run Azure apps locally with auto-dependencies, dashboard, and AI debugging	jongio.github.io/azd-app
azd rest	Authenticated REST API calls with automatic scope detection	jongio.github.io/azd-rest

Install both in one step with the extension pack: azd extension install jongio.azd.

Two entries were removed from this table rather than updated. azd copilot is retired and being archived; it still resolves for existing installs but is no longer maintained. azd exec is no longer needed at all, because azd exec shipped as a built-in azd command in v1.25.1.

🌐 Extension Hub: jongio.github.io/azd-extensions — Browse all extensions, quick install, and registry info.

---

📄 License

MIT License - see LICENSE for details.

---

Ready to get started?

🌐 Get Started at jongio.github.io/azd-app →

Built with ❤️ for Azure developers