OpenSkillIndex← back to search
claude-codedevelopment

Claude-skill-registry local-dev-server

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

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/local-dev-server" ~/.claude/skills/majiayu000-claude-skill-registry-local-dev-server && rm -rf "$T"
manifest: skills/data/local-dev-server/SKILL.md
tags
#pm2#server-management#development#automation#node
source content

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

# 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

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

ACT Ecosystem

# 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

TopicFile
Full PM2 reference
refs/pm2-commands.md

Related Skills

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