Boot Local
Kill and restart all local development services when the dev environment needs a fresh start.
<when_to_use>
When to Use
Invoke when user says:
- •"boot local"
- •"restart local"
- •"reboot dev"
- •"restart all services"
- •"kill and restart" </when_to_use>
| Phase | Action | Reference |
|---|---|---|
| 1 | Kill running processes (ports 8080, 3001) | process-killing.md |
| 2 | Wait for termination, verify ports free | process-killing.md |
| 3 | Start all 3 services in background | service-startup.md |
| 4 | Verify startup (check logs) | service-startup.md |
| 5 | Display status report | Final output |
Note: Use run_in_background: true for all three start commands to avoid blocking.
</workflow>
| Service | Command | Port | URL |
|---|---|---|---|
| Worker | npm run worker:dev | 3001 | http://localhost:3001/health |
| Edge Functions | npx supabase functions serve --env-file supabase/.env.local | 54321 | http://127.0.0.1:54321/functions/v1/ |
| Dev Server | npm run dev -- --port 8080 | 8080 | http://localhost:8080 |
<approval_gates>
Approval Gates
| Gate | Phase | Question |
|---|---|---|
| None | - | No destructive operations; all local process cleanup |
</approval_gates>
<quick_reference>
Quick Reference
bash
# Find process on port netstat -ano | findstr :8080 | findstr LISTENING # Kill by PID taskkill //F //PID <pid> # Start services (use run_in_background: true) npm run worker:dev npx supabase functions serve --env-file supabase/.env.local npm run dev -- --port 8080
For detailed steps: references/process-killing.md For error recovery: references/error-recovery.md </quick_reference>
<references> ## References- •references/process-killing.md - Finding and killing processes
- •references/service-startup.md - Starting dev services
- •references/error-recovery.md - Troubleshooting failures </references>
<version_history>
Version History
- •
v2.1.0 (2025-01-18): AI optimization updates
- •Add blockquote summary after title
- •Soften directive language per Opus 4.5 guidance
- •
v2.0.0 (2025-12-28): Refactored to follow skill-authoring-patterns
- •Added XML tags for structure
- •Created references/ for detailed content
- •Reduced from 197 to ~90 lines
- •
v1.0.1 (2025-12-21): Fix edge functions env file
- •Added
--env-file supabase/.env.local
- •Added
- •
v1.0.0 (2025-12-21): Initial release </version_history>