Start or restart the .NET Aspire AppHost via the developer CLI.

MITAuto-check passed

Install Aspire Restart

skills CLI
$ npx skills add platformplatform/PlatformPlatform --skill aspire-restart -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install platformplatform/PlatformPlatform aspire-restart --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/platformplatform/PlatformPlatform.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/aspire-restart .claude/skills/aspire-restart && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aspire-restart
GitHub stars
441
Token cost
~415 tokens
SKILL.md length
212 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Start or restart the .NET Aspire AppHost via the developer CLI.

  • SKILL.md covers When to use, Port allocation, Output is fire-and-forget and Stopping Aspire
  • Calls dotnet

What it does

Aspire Restart is an agent skill from platformplatform/PlatformPlatform. 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.

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with .NET. The repository describes itself as: A platform designed for building enterprise-grade, multi-tenant products using Azure, .NET, React, TypeScript, Infrastructure as Code, etc. The licence is MIT.

Example prompts

  • “/aspire-restart”

What it can do on your machine

Read from SKILL.md and the folder at commit 269de1c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • dotnet

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aspire Restart loads about 415 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 212 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~415

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from platformplatform/PlatformPlatform at commit 269de1c, republished under its MIT licence (© platformplatform). 212 words, ~415 tokens.

Download SKILL.mdSave it as .claude/skills/aspire-restart/SKILL.md (or your agent's skills folder).
name
aspire-restart
description
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`.

Restart Aspire

bash
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.

© platformplatform, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/aspire-restart of platformplatform/PlatformPlatform.

Open the folder on GitHubat commit 269de1c

Compare with similar skills

Aspire Restart next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aspire Restart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aspire Restart this skillplatformplatform/PlatformPlatform441—~415Automated safety check: PassMIT
Minimax DOCXpoco-ai/poco-claw1.4k7 repos~3.9kAutomated safety check: PassMIT
Microsoft Skill CreatorMicrosoftDocs/mcp1.9k3 repos~2.1kAutomated safety check: PassCC-BY-4.0
Speckit ConstitutionWeihanLi/WeihanLi.Common24211 repos~2.1kAutomated safety check: PassApache-2.0
Copilot Session Failure Analysisdotnet/maui23k—~3.4kAutomated safety check: PassMIT
Microsoft Code ReferenceMicrosoftDocs/mcp1.9k4 repos~1.1kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Minimax DOCX

    poco-ai/poco-claw

    Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET).

    1.4k GitHub starsUsed in 7 repos~3.9k tokens
    Documents & OfficeAuto-check passed
  • Microsoft Skill Creator

    MicrosoftDocs/mcp

    Official

    Create agent skills for Microsoft technologies using official documentation.

    1.9k GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Speckit Constitution

    WeihanLi/WeihanLi.Common

    Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.

    242 GitHub starsUsed in 11 repos~2.1k tokens
    DevelopmentAuto-check passed
  • Mines local Copilot CLI session logs for dotnet/maui to rank costly or failing runs, tag recurring failure modes, propose repo edits and emit guard evals.

    23k GitHub stars~3.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Microsoft Code Reference

    MicrosoftDocs/mcp

    Official

    Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.

    1.9k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Audits and updates os-packages.json files listing the Linux packages each .NET release needs per distro, then regenerates the Markdown from the JSON.

    22k GitHub stars~2.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from platformplatform/PlatformPlatform

All 18 skills in this repo
  • Create Prd

    platformplatform/PlatformPlatform

    Create a product requirement document (PRD) for a new feature.

    441 GitHub stars~3k tokensUpdated 14 days ago
    Auto-check passed
  • Rebuild Branch

    platformplatform/PlatformPlatform

    Rebuild a stale branch by cherry-picking each commit onto a fresh branch off main, using a ralph-loop to validate each commit (build, test, format, lint, optional e2e) before moving on.

    441 GitHub stars~2.1k tokensUpdated 14 days ago
    Auto-check: notes
  • Swc Plugin Compatibility

    platformplatform/PlatformPlatform

    Diagnose and fix Lingui SWC plugin compatibility errors with Next.js, Rspack, or other SWC runtimes.

    441 GitHub stars~873 tokensUpdated 14 days ago
    Auto-check passed
  • Commit

    platformplatform/PlatformPlatform

    Commit session changes to git. An agent skill from platformplatform/PlatformPlatform.

    441 GitHub stars~567 tokensUpdated 14 days ago
    Auto-check passed
  • E2E

    platformplatform/PlatformPlatform

    Run end-to-end Playwright tests via the developer CLI. An agent skill from platformplatform/PlatformPlatform.

    441 GitHub stars~542 tokensUpdated 14 days ago
    Auto-check passed
  • Enhanced Message Context

    platformplatform/PlatformPlatform

    Provide additional context for messages based on the codebase and the context of the message to improve the quality of the translations.

    441 GitHub stars~1.6k tokensUpdated 14 days ago
    Auto-check passed

Works with

Questions about Aspire Restart

What does Aspire Restart do?

Start or restart the .NET Aspire AppHost via the developer CLI. Aspire Restart is an agent skill from platformplatform/PlatformPlatform.NET Aspire AppHost via the developer CLI.

How do I install Aspire Restart in Claude Code?

Run `npx skills add platformplatform/PlatformPlatform --skill aspire-restart -a claude-code`. Or copy the skill folder (.claude/skills/aspire-restart in platformplatform/PlatformPlatform) into .claude/skills/aspire-restart in your project. Claude Code loads it when a task matches its description.

How do I install Aspire Restart in Codex?

Run `npx skills add platformplatform/PlatformPlatform --skill aspire-restart -a codex`. Or copy the skill folder (.claude/skills/aspire-restart in platformplatform/PlatformPlatform) into .agents/skills/aspire-restart in your project. Codex loads it when a task matches its description.

Can I use Aspire Restart in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add platformplatform/PlatformPlatform --skill aspire-restart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aspire-restart, .gemini/skills/aspire-restart, .github/skills/aspire-restart and .opencode/skills/aspire-restart in your project.

What does Aspire Restart need to run?

Going by SKILL.md and its folder, Aspire Restart needs the command-line tools its instructions call (dotnet).

Does Aspire Restart access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aspire Restart safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aspire Restart use?

Aspire Restart is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aspire Restart use?

About 415 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Aspire Restart?

Skills that share tags, products or a category with Aspire Restart: Minimax DOCX (poco-ai/poco-claw, 1.4k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Speckit Constitution (WeihanLi/WeihanLi.Common, 242 stars) and Copilot Session Failure Analysis (dotnet/maui, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aspire Restart?

platformplatform (a GitHub organization) maintains it in platformplatform/PlatformPlatform, which has 441 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 24, 2026.

Source: platformplatform/PlatformPlatform on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.