aspire

Orchestrates Aspire AppHost resources via CLI commands for starting, rebuilding, and debugging distributed applications.

7|3|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/islamu-ngo/Event --skill aspire-islamu-ngo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aspire
Source: https://github.com/islamu-ngo/Event/tree/main/.agents/skills/aspire
Command: npx skills add https://github.com/islamu-ngo/Event --skill aspire-islamu-ngo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a distributed Aspire application involves many CLI operations—starting resources, waiting for health, rebuilding single services, and reading logs or traces—and doing them wrong (like restarting the whole AppHost for one change) wastes time and breaks state. ## Core Features & Use Cases - Resource Lifecycle Control: Start, stop, restart, rebuild, and wait on individual AppHost resources with commands like aspire start --isolated and aspire resource <name> rebuild. - Observability & Debugging: Inspect resource status, console logs, structured OpenTelemetry logs, and distributed traces via aspire describe, aspire otel logs, and aspire otel traces. - Integrations & MCP Tools: Add integrations with aspire add, search official docs with aspire docs search, and invoke resource-exposed MCP tools via aspire mcp call. - Use Case: While working in a git worktree, run aspire start --isolated, wait for your API with aspire wait myapi, then rebuild only the changed .NET service instead of restarting the entire AppHost. ## Quick Start Ask the assistant to start the Aspire AppHost in isolated mode and wait until the API resource is healthy before making changes.

Frequently Asked Questions about aspire

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

FAQPage Schema
How do I start an Aspire AppHost application?▼

Run `aspire start` to launch the AppHost in the background. When working in a git worktree, use `aspire start --isolated` to avoid port conflicts and shared user secrets with other running instances.

How do I rebuild a single .NET service in Aspire without restarting everything?▼

Use `aspire resource <name> rebuild`, which coordinates stop, build, and restart for just that resource. Only restart the full AppHost with `aspire start` when the AppHost project itself changed.

How do I view logs and traces for Aspire resources?▼

Use `aspire logs <resource>` for console output, `aspire otel logs <resource>` for structured logs, and `aspire otel traces <resource>` for distributed traces. You can also filter logs by trace with `aspire otel logs --trace-id <id>`.

When should I not use the Aspire CLI workflow?▼

This workflow does not apply to plain dotnet apps without an AppHost, container-only deployments, or cloud deployment scenarios. It is specifically for orchestrating resources defined in an Aspire AppHost project.

How do I add a new integration to an Aspire AppHost?▼

Search documentation with `aspire docs search <query>`, read the guide via `aspire docs get <slug>`, then run `aspire add` to add the integration package. Restart the app with `aspire start` for the new resource to take effect.