Agent skill

local-dev-server

PM2-based local development server management for Empathy Ledger. Handles port conflicts and auto-restart.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/local-dev-server

SKILL.md

Local Dev Server

PM2-based server management for reliable local development.

When to Use

  • Starting/stopping dev server
  • "Address already in use" errors
  • Server crashes and needs restart
  • Testing API endpoints

Quick Commands

bash
# Start server (port 3030)
pm2 start npm --name "empathy-ledger" -- run dev

# Restart after code changes
pm2 restart empathy-ledger

# View logs
pm2 logs empathy-ledger

# Stop server
pm2 stop empathy-ledger

Fix Port Conflicts

bash
# Kill process on port and restart
lsof -ti :3030 | xargs kill -9
pm2 start npm --name "empathy-ledger" -- run dev

ACT Ecosystem

bash
# Start all projects
/Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh start

# Restart all
/Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh restart

# Stop all
/Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh stop

PM2 vs npm run dev

  • Use PM2: Auto-restart, centralized logs, multi-project
  • Use npm run dev: Quick testing, active debugging

Reference Files

Topic File
Full PM2 reference refs/pm2-commands.md

Related Skills

  • deployment-workflow - Production deployment
  • supabase-connection - Database setup

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results