{"id":34847003,"url":"https://github.com/jongio/azd-app","last_synced_at":"2026-06-08T18:01:03.106Z","repository":{"id":322411189,"uuid":"1087771037","full_name":"jongio/azd-app","owner":"jongio","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-06T01:31:51.000Z","size":80418,"stargazers_count":11,"open_issues_count":7,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-06T02:23:51.839Z","etag":null,"topics":["azd","azure","microsoft"],"latest_commit_sha":null,"homepage":"https://jongio.github.io/azd-app/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jongio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-01T16:00:37.000Z","updated_at":"2026-06-06T01:30:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jongio/azd-app","commit_stats":null,"previous_names":["jongio/azd-app"],"tags_count":187,"template":false,"template_full_name":null,"purl":"pkg:github/jongio/azd-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongio%2Fazd-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongio%2Fazd-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongio%2Fazd-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongio%2Fazd-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jongio","download_url":"https://codeload.github.com/jongio/azd-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongio%2Fazd-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34073810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azd","azure","microsoft"],"created_at":"2025-12-25T18:23:32.934Z","updated_at":"2026-06-08T18:01:03.100Z","avatar_url":"https://github.com/jongio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# azd app\n\n### **Run Azure Apps Locally**\n\nOne command starts all services, manages dependencies, and provides real-time monitoring.\n\n[![CI](https://github.com/jongio/azd-app/actions/workflows/ci.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/ci.yml)\n[![Release](https://github.com/jongio/azd-app/actions/workflows/release.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/release.yml)\n[![codecov](https://codecov.io/gh/jongio/azd-app/branch/main/graph/badge.svg)](https://codecov.io/gh/jongio/azd-app)\n[![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)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![CodeQL](https://github.com/jongio/azd-app/actions/workflows/codeql.yml/badge.svg)](https://github.com/jongio/azd-app/actions/workflows/codeql.yml)\n[![Go Reference](https://pkg.go.dev/badge/github.com/jongio/azd-app/cli.svg)](https://pkg.go.dev/github.com/jongio/azd-app/cli)\n[![govulncheck](https://img.shields.io/badge/govulncheck-passing-brightgreen)](https://github.com/jongio/azd-app/actions/workflows/govulncheck.yml)\n[![golangci-lint](https://img.shields.io/badge/golangci--lint-enabled-blue)](https://github.com/jongio/azd-app/actions/workflows/ci.yml)\n[![Go Version](https://img.shields.io/badge/go-1.26.4-blue)](https://go.dev/)\n[![Platform Support](https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey)](https://github.com/jongio/azd-app)\n\n\u003cbr /\u003e\n\n[**🌐 Visit the Website →**](https://jongio.github.io/azd-app/)\n\n*Interactive docs, guided tour, and live demos*\n\n[**📦 Part of azd Extensions →**](https://jongio.github.io/azd-extensions/)\n\n*Browse all Azure Developer CLI extensions by Jon Gallant*\n\n\u003cbr /\u003e\n\n---\n\n\u003c/div\u003e\n\n## ⚡ One-Command Start\n\nStop juggling terminals. Run `azd app run` and watch everything come alive.\n\n```bash\nazd app run\n```\n\nThat's it. All your services start with dependencies resolved automatically.\n\n\u003cdiv align=\"center\"\u003e\n\n![azd app dashboard](web/public/screenshots/dashboard-console.png)\n\n*Real-time dashboard showing all your running services*\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 📊 Real-time Dashboard\nMonitor all your services in one place with live status updates and health checks. See what's running, what's failing, and where to click.\n\n![Dashboard Resources](web/public/screenshots/dashboard-resources-cards.png)\n\n### 📝 Unified Logs\nStream 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.\n\n![Console Logs](web/public/screenshots/dashboard-console.png)\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔧 Auto Dependencies\nAutomatically installs packages, creates virtual environments, and resolves requirements across Node.js, Python, .NET, and more.\n\n### 🧪 Multi-Language Testing\nRun tests across all services with `azd app test`. Supports Node.js, Python, and .NET with unified coverage reporting.\n\n### 🤖 AI-Powered Debugging\nConnect GitHub Copilot via MCP to analyze logs, diagnose issues, and suggest fixes. Your AI pair programmer that understands your running app.\n\n### ❤️ Health Monitoring\nAutomatic health checks with visual indicators. Know when services need attention before your users do.\n\n### 🚀 Zero Configuration\nWorks with your existing `azure.yaml`. No new config files, no complex setup. Just run and go.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🎯 Quick Start\n\n### 1. Install Azure Developer CLI\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWindows\u003c/b\u003e\u003c/summary\u003e\n\n```powershell\nwinget install microsoft.azd\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003emacOS\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nbrew tap azure/azd \u0026\u0026 brew install azd\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eLinux\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ncurl -fsSL https://aka.ms/install-azd.sh | bash\n```\n\u003c/details\u003e\n\n### 2. Install azd-app\n\n```bash\n# Add extension source\nazd extension source add -n jongio -t url -l https://jongio.github.io/azd-extensions/registry.json\n\n# Install the extension\nazd extension install jongio.azd.app\n```\n\n### 3. Initialize Your Project\n\n```bash\ncd your-project\nazd app init\n```\n\nThis scans your project, detects services/frameworks/dependencies, and generates `azure.yaml`.\n\n### 4. Run Your App\n\n```bash\nazd app run\n```\n\n\u003cdiv align=\"center\"\u003e\n\n### 📚 Want the full walkthrough?\n\n[**Start the Guided Tour →**](https://jongio.github.io/azd-app/tour/1-install/)\n\n\u003c/div\u003e\n\n---\n\n## 🤖 AI Integration with MCP\n\nazd app includes a Model Context Protocol (MCP) server that connects your running application to AI assistants like GitHub Copilot.\n\n**12 AI Tools Available:**\n- **Observability**: `get_services`, `get_service_logs`, `get_service_errors`, `get_project_info`\n- **Operations**: `run_services`, `stop_services`, `start_service`, `restart_service`, `install_dependencies`\n- **Configuration**: `check_requirements`, `get_environment_variables`, `set_environment_variable`\n\nAsk Copilot things like:\n- *\"Why is my API returning 500 errors?\"*\n- *\"Restart the web service and show me the logs\"*\n- *\"What environment variables are set for the API?\"*\n\n[**Learn about MCP Integration →**](https://jongio.github.io/azd-app/mcp/)\n\n---\n\n## 📋 Supported Languages \u0026 Frameworks\n\n| Language | Package Managers | Frameworks |\n|----------|-----------------|------------|\n| **Node.js** | npm, pnpm, yarn | Express, Next.js, React, Vue, Angular, Svelte, Astro, NestJS |\n| **Python** | pip, uv, poetry | FastAPI, Flask, Django, Streamlit, Gradio |\n| **.NET** | dotnet | ASP.NET Core, Aspire |\n| **Java** | Maven, Gradle | Spring Boot, Quarkus |\n| **Go** | go | - |\n| **Rust** | cargo | - |\n| **PHP** | composer | Laravel |\n| **Docker** | docker | Docker Compose |\n\n---\n\n## 📊 By the Numbers\n\n\u003cdiv align=\"center\"\u003e\n\n| 12 MCP Tools | \u003c5 min Setup | 100% Open Source | Works with Copilot |\n|:-------------:|:------------:|:----------------:|:------------------:|\n| Full AI integration | Quick start | MIT License | GitHub Copilot ready |\n\n\u003c/div\u003e\n\n---\n\n## 📖 Documentation\n\n\u003cdiv align=\"center\"\u003e\n\n| | |\n|:---:|:---:|\n| [**🚀 Quick Start**](https://jongio.github.io/azd-app/quick-start/) | Get running in under 5 minutes |\n| [**🎯 Guided Tour**](https://jongio.github.io/azd-app/tour/1-install/) | Step-by-step walkthrough |\n| [**📚 CLI Reference**](https://jongio.github.io/azd-app/reference/cli/) | All commands documented |\n| [**🤖 MCP Guide**](https://jongio.github.io/azd-app/mcp/) | AI integration setup |\n\n\u003c/div\u003e\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n---\n\n## 🔗 azd Extensions\n\nazd app is part of a suite of Azure Developer CLI extensions by [Jon Gallant](https://github.com/jongio).\n\n| Extension | Description | Website |\n|-----------|-------------|---------|\n| **[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/) |\n| **[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/) |\n| **[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/) |\n| **[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/) |\n\n🌐 **Extension Hub**: [jongio.github.io/azd-extensions](https://jongio.github.io/azd-extensions/) — Browse all extensions, quick install, and registry info.\n\n---\n\n## 📄 License\n\nMIT License - see [LICENSE](./LICENSE) for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### Ready to get started?\n\n[**🌐 Get Started at jongio.github.io/azd-app →**](https://jongio.github.io/azd-app/)\n\n\u003cbr /\u003e\n\nBuilt with ❤️ for Azure developers\n\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongio%2Fazd-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjongio%2Fazd-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongio%2Fazd-app/lists"}