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.
| 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
# 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/process-killing.md - Finding and killing processes
- references/service-startup.md - Starting dev services
- references/error-recovery.md - Troubleshooting failures
<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>