Stats
Actions
Tags
From zacs-claude-skills
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.
How this skill is triggered — by the user, by Claude, or both
Slash command
/zacs-claude-skills:skills/boot-localThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> Kill and restart all local development services when the dev environment needs a fresh start.
Kill and restart all local development services when the dev environment needs a fresh start.
<when_to_use>
Invoke when user says:
| 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>
| Gate | Phase | Question |
|---|---|---|
| None | - | No destructive operations; all local process cleanup |
</approval_gates>
<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<version_history>
v2.1.0 (2025-01-18): AI optimization updates
v2.0.0 (2025-12-28): Refactored to follow skill-authoring-patterns
v1.0.1 (2025-12-21): Fix edge functions env file
--env-file supabase/.env.localv1.0.0 (2025-12-21): Initial release </version_history>
npx claudepluginhub enbyaugust/zacs-claude-skillsSets up a dev server that auto-rotates to the next free port instead of killing the process on the preferred port. Ships a port-probe helper and launcher template.
Switch between local and production database environments by updating .env.local, killing running processes, and providing restart instructions. Use when user says "switch to local database", "switch to production database", or "change database environment".
Manages non-containerized local services with Process Compose: YAML config, health checks, restart policies, process dependencies, TUI, REST API, MCP server, and verified single-binary install.