boot-local

name	boot-local
description	Kill all running local development processes (worker, edge functions, dev server), wait for termination, then restart them. Dev server runs on port 8080. Use when user says "boot local", "restart local", "reboot dev", or needs to refresh local services.
allowed-tools	Bash, TaskOutput
version	2.1.0

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>

## Workflow

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.

## 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

<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

• 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

• v1.0.0 (2025-12-21): Initial release </version_history>