Agent skill
local-dev-server
PM2-based local development server management for Empathy Ledger. Handles port conflicts and auto-restart.
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
# 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
| Topic | File |
|---|---|
| Full PM2 reference | refs/pm2-commands.md |
Related Skills
deployment-workflow- Production deploymentsupabase-connection- Database setup
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?