Installs into .claude/skills of the current project.
Are you the author of Local Dev Server?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/majiayu000-local-dev-server)
---
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
| Topic | File |
|-------|------|
| Full PM2 reference | `refs/pm2-commands.md` |
## Related Skills
- `deployment-workflow` - Production deployment
- `supabase-connection` - Database setup
