local-dev-server

Manage a local development server with PM2 for Empathy Ledger.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines local development by orchestrating a PM2-based server, preventing port conflicts and enabling automatic restarts.

Core Features & Use Cases

  • PM2-based server orchestration for reliable local development
  • Port conflict resolution and graceful restarts
  • Quick access to real-time logs for debugging

Quick Start

Start the local development server with PM2 and use the provided commands to manage it:

  • Start: pm2 start npm --name "empathy-ledger" -- run dev
  • Restart: pm2 restart empathy-ledger
  • Logs: pm2 logs empathy-ledger
  • Stop: pm2 stop empathy-ledger If port 3030 is in use, identify the process on the port and terminate it, then restart the server and verify via logs.

Frequently Asked Questions about local-dev-server

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

FAQPage Schema
How do I manage a local development server with PM2 to prevent port conflicts?

Manage a local development server with PM2 by starting it with a named process and using built-in commands to restart, stop, or view logs. If a port conflict occurs, identify the process occupying the port, terminate it, and restart the server to ensure reliable operation.

What's the best way to automatically restart a Node.js development server after code changes?

The best way to automatically restart a Node.js server after code changes is to orchestrate it with PM2. PM2 provides predictable restarts and centralized log access, ensuring reliable local development without manual intervention.

Do I need PM2 installed to run a local development server for my Node.js project?

Yes, you need PM2 installed to run this local development server. The setup also requires an npm run dev script in your project to properly orchestrate the server and enable features like automatic restarts and centralized logging.

How do I access real-time logs for debugging a PM2-managed Node.js server?

Access real-time logs for debugging a PM2-managed Node.js server by running the pm2 logs command with your server's process name. This provides quick access to centralized log output directly in your terminal during local development.

Why does my local development server fail to start when port 3030 is already in use?

Your local development server fails to start when port 3030 is in use because another process is already bound to it. You must identify the process occupying port 3030, terminate it, and then restart your PM2-managed server to resolve the conflict.