server-restart

Restart the FOUNDATION dev server with stop, optional cache clean, and start sequence.

19|3|Updated Jul 19, 2024
One-click install
npx skills add https://github.com/danielterra/FOUNDATION --skill server-restart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: server-restart
Source: https://github.com/danielterra/FOUNDATION/tree/main/.claude/skills/server-restart
Command: npx skills add https://github.com/danielterra/FOUNDATION --skill server-restart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Restarting the FOUNDATION dev server after config changes or when the Vite/SvelteKit runner goes zombie can cause downtime and manual steps. This Skill automates the stop→start lifecycle to recover quickly and with fewer errors.

Core Features & Use Cases

  • Stop the server (PM2 stop+delete + orphan sweep) to clean up a stuck process.
  • Optional cache clean before starting (removes node_modules/.vite and .svelte-kit) to ensure a clean boot.
  • Start the server (PM2 start + readiness poll) and report whether a cache was cleaned.
  • Enforce the canonical stop→start workflow and prevent unsafe manual restarts.

Quick Start

Instruct the AI to restart the FOUNDATION dev server and perform a cache clean if needed.

Frequently Asked Questions about server-restart

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

FAQPage Schema
How do I restart a Vite SvelteKit dev server that became unresponsive?

To restart an unresponsive Vite SvelteKit dev server, this Skill automates a PM2 stop and delete sequence with an orphan sweep to kill zombie processes, then starts the server and polls for readiness.

Why does my Vite SSR module runner go zombie after config changes?

A Vite SSR module runner goes zombie when config changes leave orphan processes. This Skill recovers the dev server by enforcing a canonical stop, optional cache clean, and start path to clear stuck states.

What's the best way to clean the Vite cache before restarting a dev server?

The best way to clean the Vite cache before restarting is using the optional cache clean step, which removes node_modules/.vite and .svelte-kit directories to ensure a clean boot after updates.

How do I stop a PM2 dev server and sweep orphan processes?

To stop a PM2 dev server and sweep orphan processes, this Skill performs a PM2 stop and delete operation followed by an orphan sweep to clear any remaining zombie processes before startup.

When do I need to clean the SvelteKit cache for a dev server restart?

You need to clean the SvelteKit cache during a dev server restart when a clean boot is required after updates or when the Vite SSR module runner is unresponsive and a standard stop and start fails.

Does this dev server restart workflow prevent unsafe manual restarts?

Yes, this dev server restart workflow prevents unsafe manual restarts by enforcing a canonical stop to start path, ensuring proper process cleanup and readiness polling before the server is considered active.