aspire-orchestration

Automate Aspire AppHost lifecycle management and recovery from file locks and port conflicts.

Updated Nov 11, 2025
One-click install
npx skills add https://github.com/eruvalca/Calcio --skill aspire-orchestration-eruvalca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-orchestration
Source: https://github.com/eruvalca/Calcio/tree/main/.agents/skills/aspire-orchestration
Command: npx skills add https://github.com/eruvalca/Calcio --skill aspire-orchestration-eruvalca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Aspire orchestration frontline skill helps you manage the AppHost lifecycle and recover from file locks, port conflicts, and orphaned processes across Aspire projects.

Core Features & Use Cases

  • Start/stop/wait lifecycle control for AppHost with guardrails.
  • Automatic detection of common errors like MSB3491 and CS2012 and guided recovery sequences.
  • Safe cleanup and isolated operation in worktrees; supports "aspire start" best practice; handoff to aspireify.

Quick Start

Start the Aspire AppHost with aspire start and follow the recovery steps when file locks or port conflicts occur.

Frequently Asked Questions about aspire-orchestration

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

FAQPage Schema
How do I recover from MSB3491 and CS2012 file lock errors during Aspire AppHost startup?

To resolve MSB3491 and CS2012 file lock errors during Aspire AppHost startup, apply guided recovery sequences and resource-safe cleanup. The orchestration detects these build failures automatically and executes non-interactive recovery patterns to clear locked files.

What is the best way to manage Aspire AppHost startup and shutdown lifecycle safely?

The best way to manage Aspire AppHost lifecycle safely is using orchestrated start, stop, and wait commands with built-in guardrails. This enforces wait conditions and resource-safe cleanup, preventing orphaned processes during standard operations and across git worktrees.

How do I fix port conflicts when running Aspire AppHost in git worktrees?

To fix port conflicts when running Aspire AppHost in git worktrees, apply isolated operation and resource-safe cleanup. The orchestration detects port conflicts during startup and executes recovery patterns to ensure safe, non-interactive process isolation across worktrees.

Can I run Aspire orchestration non-interactively with JSON formatted output?

Yes, you can run Aspire orchestration non-interactively with JSON formatting. The lifecycle management supports non-interactive operation and JSON output, enabling automated describe, wait, and recovery workflows for AppHost resources without manual intervention.

Why does Aspire AppHost fail to start with orphaned processes and how do I clean them up?

Aspire AppHost fails to start with orphaned processes due to incomplete shutdowns leaving active resource locks. The orchestration cleans them up by applying resource-safe cleanup patterns and aspire wait conditions to safely terminate orphaned processes before restarting.