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

---

⚡ 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. Enable Extensions & Install azd-app

# Enable extensions
azd config set alpha.extensions.enabled on

# Add azd-app extension source
azd extension source add -n app -t url -l https://raw.githubusercontent.com/jongio/azd-app/main/registry.json

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

3. Run Your App

cd your-azd-project
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.

10 AI Tools Available:

• Observability: get_services, get_service_logs, get_project_info
• Operations: run_services, stop_services, 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

10+ 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

---

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

---

📄 License

MIT License - see LICENSE for details.

---

Ready to supercharge your local development?

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

Built with ❤️ for Azure developers