# Local Dev Server

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

- Skill: `majiayu000/local-dev-server` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/local-dev-server`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/local-dev-server/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/local-dev-server

---


# 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