Aspire Restart
Apps & Automationaspire-restartAspire Restart is an Agent Skill for apps & automation published in the platformplatform/PlatformPlatform repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Start or restart the .NET Aspire AppHost via the developer CLI. Always use this, never the developer CLI's `run` command, `aspire run`, or `aspire restart`.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/platformplatform/PlatformPlatform/blob/HEAD/.claude/skills/aspire-restart/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aspire-restart, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Restart Aspire
dotnet run --project developer-cli -- restart
Use developer-cli exactly as written - do not expand to an absolute worktree path.
Stops any running Aspire AppHost and starts a fresh instance. Detached by default - the CLI returns immediately while Aspire keeps running.
Always use restart, even when nothing is running yet. It is a no-op when Aspire is not up, and the safe default in every other case. Never use the developer CLI's run command, aspire run, or aspire restart.
--public-url <url>- setPUBLIC_URL(e.g. an ngrok URL)
When to use
- After backend or frontend changes -
restartis the safe default; it works whether Aspire is up or not. - To run database migrations.
- When hot reload breaks or stops picking up changes.
- Before running e2e tests on a fresh stack.
Port allocation
Fully automatic. On a fresh checkout the developer CLI bootstraps .workspace/port.txt: the root gets the default base port; worktrees scan a fixed list of candidates and pick the first one whose ports are all free. Once written, the file is the authoritative allocation for the lifetime of the checkout.
Output is fire-and-forget
The CLI prints Aspire is restarting on https://app.dev.localhost:<port> and exits before Aspire is fully ready.
Stopping Aspire
To stop without restarting, run dotnet run --project developer-cli -- stop. Rarely needed - prefer restart for everyday use.