aspire-cli

Guide Aspire CLI command selection for managing AppHost projects.

5|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/arisng/github-copilot-fc --skill aspire-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-cli
Source: https://github.com/arisng/github-copilot-fc/tree/main/skills/aspire-cli
Command: npx skills add https://github.com/arisng/github-copilot-fc --skill aspire-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users in selecting and using Aspire CLI commands to manage AppHost projects.

Core Features & Use Cases

  • Command selection guidance: Navigate the Aspire CLI to create, init, run, add, update, publish, deploy, do, exec, config, and cache commands.
  • Context-aware workflows: Ensure the correct AppHost directory, channel selection, and SDK requirements before executing commands.
  • Real-world guidance: Provide concise, example-driven steps for common dev workflows and troubleshooting.

Quick Start

Start from a project folder, run aspire init or aspire new to integrate Aspire into your solution; then use aspire run to start AppHost orchestration and observe endpoints.

Frequently Asked Questions about aspire-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize an Aspire AppHost project from an existing solution?

To initialize an Aspire AppHost project, navigate to your solution folder and run `aspire init` to integrate Aspire orchestration. This command sets up the required AppHost project structure and configuration files.

What Aspire CLI commands are available for deploying and publishing applications?

The Aspire CLI provides `aspire publish` and `aspire deploy` commands to manage application deployment. These commands handle generating manifests and provisioning cloud resources for Aspire-based applications.

Do I need a specific .NET SDK version to run Aspire CLI workflows?

Yes, the Aspire CLI enforces context checks for required SDKs before executing commands. You must have the correct .NET SDK installed and selected, along with the appropriate channel, to manage AppHost projects.

How do I start and debug an Aspire orchestration locally?

Use `aspire run` from your AppHost directory to start local orchestration and observe service endpoints. For troubleshooting, the CLI includes debug commands to inspect AppHost behavior and resolve runtime issues.

What changed in Aspire CLI command behavior with version 13.1?

Aspire 13.1 introduced specific behavior changes to CLI commands for managing AppHost projects. The CLI provides updated guidance to navigate these modifications across workflows like running, updating, and publishing.

Why is my Aspire CLI command failing to detect the AppHost project?

Aspire CLI commands fail when the working directory lacks an AppHost project. The CLI enforces context checks for AppHost presence, working directory validity, and channel selection before executing any workflow commands.