AgentSkillsCN

local-dev-server

为 Empathy Ledger 构建基于 PM2 的本地开发服务器管理方案。可有效处理端口冲突并实现自动重启。

SKILL.md
--- frontmatter
name: local-dev-server
description: PM2-based local development server management for Empathy Ledger. Handles port conflicts and auto-restart.

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

TopicFile
Full PM2 referencerefs/pm2-commands.md

Related Skills

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