server-management

Ensure a development server is healthy and updated to HEAD before testing.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/matthewfrazier/mobissh --skill server-management-matthewfrazier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: server-management
Source: https://github.com/matthewfrazier/mobissh/tree/main/.claude/skills/server-management
Command: npx skills add https://github.com/matthewfrazier/mobissh --skill server-management-matthewfrazier

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

A running dev server can drift from HEAD, causing changes to appear inconsistently during tests. This skill ensures the server remains healthy and aligned with the latest commit before any browser or emulator testing.

Core Features & Use Cases

  • Proactive health checks and automatic restarts when the server becomes stale.
  • Version gating to ensure the served code matches HEAD during tests and deployments.
  • Lightweight lifecycle management using the provided server-ctl.sh tool.

Quick Start

Ensure the development server is healthy and at HEAD before testing by running the provided server-ctl.sh ensure.

Frequently Asked Questions about server-management

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

FAQPage Schema
How do I check if my development server is healthy before running browser tests?

Check server health by running an HTTP GET request against the endpoint. The server-management skill automates this validation and coordinates automatic restarts if the server is stale or unresponsive before testing begins.

Why does my dev server drift from HEAD and serve stale code during localhost checks?

A dev server drifts from HEAD when running processes are not updated after new commits. The skill reads HEAD from git and applies version gating to ensure the served code matches the latest commit before tests.

How do I automatically restart a Node.js dev server when it becomes stale?

Automatically restart a stale Node.js dev server by using the server-ctl.sh ensure command. This script manages PID and logs, detects when the running version no longer matches HEAD, and triggers an automatic restart.

Does the server-management automation work with custom BASE_PATH configurations?

Yes, server-management automation supports optional BASE_PATH configurations. This allows the health check HTTP GET requests and lifecycle management to correctly target servers running under custom base paths or subdirectories.

What's the best way to gate test execution until the server matches the latest git commit?

Gate test execution by validating the running server version against git HEAD before allowing browser or emulator tests to proceed. The skill coordinates this version gating to prevent inconsistent test results from stale code.