SKILL.md
Boot Local
Kill and restart all local development services when the dev environment needs a fresh start.
<whentouse>
When to Use
Invoke when user says:
- "boot local"
- "restart local"
- "reboot dev"
- "restart all services"
- "kill and restart"
</whentouse>
<workflow>
Workflow
| Phase | Action | Reference |
|---|---|---|
| 1 | Kill running processes (ports 8080, 3001) | [process-killing.md](references/process-killing.md) |
| 2 | Wait for termination, verify ports free | [process-killing.md](references/process-killing.md) |
| 3 | Start all 3 services in background | [service-startup.md](references/service-startup.md) |
| 4 | Verify startup (check logs) | [service-startup.md](references/service-startup.md) |
| 5 | Display status report | Final output |
Note: Use runinbackground: true for all three start commands to avoid blocking. </workflow>
<services>
Services
| 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 |
</services>
<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](references/process-killing.md) For error recovery: [references/error-recovery.md](references/error-recovery.md) </quick_reference>
<references>
References
- [references/process-killing.md](references/process-killing.md) - Finding and killing processes
- [references/service-startup.md](references/service-startup.md) - Starting dev services
- [references/error-recovery.md](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
- v1.0.0 (2025-12-21): Initial release
</version_history>