OpenParable
Skip to content
← Back to skills

Aspire Restart

Apps & Automation
aspire-restart

Aspire 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`.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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> - set PUBLIC_URL (e.g. an ngrok URL)

When to use

  • After backend or frontend changes - restart is 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.