Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jongio/azd-app

Azure Developer CLI extension for local development. One command starts all services with auto-detected dependencies, real-time dashboard, health monitoring, and GitHub Copilot AI integration via MCP.
https://github.com/jongio/azd-app

azd azure microsoft

Last synced: 9 days ago
JSON representation

Azure Developer CLI extension for local development. One command starts all services with auto-detected dependencies, real-time dashboard, health monitoring, and GitHub Copilot AI integration via MCP.

Awesome Lists containing this project

README 

          



# azd app



### **Run Azure Apps Locally**



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



[![CI](https://github.com/jongio/azd-app/actions/workflows/ci.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/ci.yml)

[![Release](https://github.com/jongio/azd-app/actions/workflows/release.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/release.yml)

[![codecov](https://codecov.io/gh/jongio/azd-app/branch/main/graph/badge.svg)](https://codecov.io/gh/jongio/azd-app)

[![Go Report Card](https://goreportcard.com/badge/github.com/jongio/azd-app/cli?refresh=1)](https://goreportcard.com/report/github.com/jongio/azd-app/cli)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![CodeQL](https://github.com/jongio/azd-app/actions/workflows/codeql.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/codeql.yml)

[![Go Reference](https://pkg.go.dev/badge/github.com/jongio/azd-app/cli.svg)](https://pkg.go.dev/github.com/jongio/azd-app/cli)

[![govulncheck](https://img.shields.io/badge/govulncheck-passing-brightgreen)](https://github.com/jongio/azd-app/actions/workflows/govulncheck.yml)

[![golangci-lint](https://img.shields.io/badge/golangci--lint-enabled-blue)](https://github.com/jongio/azd-app/actions/workflows/ci.yml)

[![Go Version](https://img.shields.io/badge/go-1.26.4-blue)](https://go.dev/)

[![Platform Support](https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey)](https://github.com/jongio/azd-app)







[**🌐 Visit the Website →**](https://jongio.github.io/azd-app/)



*Interactive docs, guided tour, and live demos*



[**📦 Part of azd Extensions →**](https://jongio.github.io/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.



```bash

azd app run

```



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






![azd app dashboard](web/public/screenshots/dashboard-console.png)



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



![Dashboard Resources](web/public/screenshots/dashboard-resources-cards.png)



### 📝 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.



![Console Logs](web/public/screenshots/dashboard-console.png)



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



```powershell

winget install microsoft.azd

```



macOS



```bash

brew tap azure/azd && brew install azd

```



Linux



```bash

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

```



### 2. Install azd-app



```bash

# 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



```bash

cd your-project

azd app init

```



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



### 4. Run Your App



```bash

azd app run

```






### 📚 Want the full walkthrough?



[**Start the Guided Tour →**](https://jongio.github.io/azd-app/tour/1-install/)






---



## 🤖 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 →**](https://jongio.github.io/azd-app/mcp/)



---



## 📋 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**](https://jongio.github.io/azd-app/quick-start/) | Get running in under 5 minutes |

| [**🎯 Guided Tour**](https://jongio.github.io/azd-app/tour/1-install/) | Step-by-step walkthrough |

| [**📚 CLI Reference**](https://jongio.github.io/azd-app/reference/cli/) | All commands documented |

| [**🤖 MCP Guide**](https://jongio.github.io/azd-app/mcp/) | AI integration setup |






---



## 🤝 Contributing



Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.



---



## 🔗 azd Extensions



azd app is part of a suite of Azure Developer CLI extensions by [Jon Gallant](https://github.com/jongio).



| Extension | Description | Website |

|-----------|-------------|---------|

| **[azd app](https://github.com/jongio/azd-app)** | Run Azure apps locally with auto-dependencies, dashboard, and AI debugging | [jongio.github.io/azd-app](https://jongio.github.io/azd-app/) |

| **[azd copilot](https://github.com/jongio/azd-copilot)** | AI-powered Azure development with 16 agents and 28 skills | [jongio.github.io/azd-copilot](https://jongio.github.io/azd-copilot/) |

| **[azd exec](https://github.com/jongio/azd-exec)** | Execute scripts with azd environment context and Key Vault integration | [jongio.github.io/azd-exec](https://jongio.github.io/azd-exec/) |

| **[azd rest](https://github.com/jongio/azd-rest)** | Authenticated REST API calls with automatic scope detection | [jongio.github.io/azd-rest](https://jongio.github.io/azd-rest/) |



🌐 **Extension Hub**: [jongio.github.io/azd-extensions](https://jongio.github.io/azd-extensions/) — Browse all extensions, quick install, and registry info.



---



## 📄 License



MIT License - see [LICENSE](./LICENSE) for details.



---






### Ready to get started?



[**🌐 Get Started at jongio.github.io/azd-app →**](https://jongio.github.io/azd-app/)







Built with ❤️ for Azure developers