| name | aspire-stop |
| description | Stop the .NET Aspire AppHost and its Docker containers via the developer CLI. Defaults to the current worktree; supports stopping all worktrees or a specific base port. |
Stop Aspire
dotnet run --project developer-cli -- stop [--all] [--port <basePort>]
Use developer-cli exactly as written - do not expand to an absolute worktree path.
Stops the Aspire AppHost and its associated Docker containers (postgres, azurite, mailpit, stripe-cli) - not just the Aspire process. Persistent containers survive a plain aspire stop by design, so this skill cleans them up too.
- (no flag) - stop the current worktree's stack
--all - stop every worktree of this repository (via git worktree list). Only use when the user explicitly asks to stop everything - never as a default
--port <basePort> - stop the worktree on that base port (e.g. 9000, 9100, 9200); also cleans up Docker containers for that port even if the worktree was deleted
The flags are mutually exclusive.
When to use
- To free up ports without restarting (rare -
aspire-restart is the everyday default).
- To stop a stack from another worktree without switching to it (
--port).
- Before deleting a worktree, to ensure its Docker containers don't leak.
Output
The CLI prints what it stopped (Aspire process trees + each docker rm --force'd container) and exits.