How do I install the Dev Server skill?

Run npx skillmds add majiayu000/dev-server-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Dev Server safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Dev Server?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Dev Server free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Dev Server?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Dev Server by majiayu000 — Agent Skill

Name: Dev Server
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Dev Server Manager

Manages the three dev services: PostgreSQL, Frontend (Vite), and API (Bun/Hono).

Quick Commands

Check Status

.claude/hooks/check-dev-status.sh

Start All Services

# Start postgres first (use the hook for proper wait)
.claude/hooks/start-dev.sh

# Or manually:
docker compose -p vacay-dev up -d postgres
# Wait for ready: docker compose -p vacay-dev exec -T postgres pg_isready -U vacay

# Start frontend and API (run in background)
pnpm dev &
pnpm dev:api &

Start Individual Services

# Postgres only
docker compose -p vacay-dev up -d postgres

# Frontend only (localhost:5173)
pnpm dev

# API only (localhost:4000)
pnpm dev:api

Stop All Services

.claude/hooks/cleanup-dev.sh

Stop Individual Services

# Stop frontend/API (matches the pnpm commands)
pkill -f "pnpm dev"
pkill -f "pnpm dev:api"

# Stop postgres
docker compose -p vacay-dev down

Service Details

Service	Port	Command	Health Check
PostgreSQL	5433	`docker compose -p vacay-dev up -d postgres`	`docker compose -p vacay-dev ps`
Frontend	5173	`pnpm dev`	`curl -s localhost:5173`
API	4000	`pnpm dev:api`	`curl -s localhost:4000`

Dev Tunnel Mode

For mobile/WebAuthn testing via Cloudflare Tunnel:

Frontend: https://photos-dev.joeczar.com
API: https://photos-dev-api.joeczar.com

Same commands - tunnel is configured on server side.

Troubleshooting

Port already in use

# Find what's using the port
lsof -i :5173
lsof -i :4000

# Kill it
kill -9 <PID>

Orphaned processes

# Run cleanup script
.claude/hooks/cleanup-dev.sh

# Or manually
pkill -f "pnpm dev"
pkill -f "pnpm dev:api"

Database connection issues

# Check postgres logs
docker compose -p vacay-dev logs postgres

# Restart postgres
docker compose -p vacay-dev restart postgres

---name: dev-server-3description: Manage development servers for vacay-photo-map. Use when starting, stopping, or checking status of postgres, frontend (Vite), or API (Bun) servers.--- # Dev Server Manager Manages the three dev services: PostgreSQL, Frontend (Vite), and API (Bun/Hono). ## Quick Commands ### Check Status ```bash .claude/hooks/check-dev-status.sh ``` ### Start All Services ```bash # Start postgres first (use the hook for proper wait) .claude/hooks/start-dev.sh # Or manually: docker compose -p vacay-dev up -d postgres # Wait for ready: docker compose -p vacay-dev exec -T postgres pg_isready -U vacay # Start frontend and API (run in background) pnpm dev & pnpm dev:api & ``` ### Start Individual Services ```bash # Postgres only docker compose -p vacay-dev up -d postgres # Frontend only (localhost:5173) pnpm dev # API only (localhost:4000) pnpm dev:api ``` ### Stop All Services ```bash .claude/hooks/cleanup-dev.sh ``` ### Stop Individual Services ```bash # Stop frontend/API (matches the pnpm commands) pkill -f "pnpm dev" pkill -f "pnpm dev:api" # Stop postgres docker compose -p vacay-dev down ``` ## Service Details | Service | Port | Command | Health Check | |---------|------|---------|--------------| | PostgreSQL | 5433 | `docker compose -p vacay-dev up -d postgres` | `docker compose -p vacay-dev ps` | | Frontend | 5173 | `pnpm dev` | `curl -s localhost:5173` | | API | 4000 | `pnpm dev:api` | `curl -s localhost:4000` | ## Dev Tunnel Mode For mobile/WebAuthn testing via Cloudflare Tunnel: - Frontend: https://photos-dev.joeczar.com - API: https://photos-dev-api.joeczar.com Same commands - tunnel is configured on server side. ## Troubleshooting ### Port already in use ```bash # Find what's using the port lsof -i :5173 lsof -i :4000 # Kill it kill -9 <PID> ``` ### Orphaned processes ```bash # Run cleanup script .claude/hooks/cleanup-dev.sh # Or manually pkill -f "pnpm dev" pkill -f "pnpm dev:api" ``` ### Database connection issues ```bash # Check postgres logs docker compose -p vacay-dev logs postgres # Restart postgres docker compose -p vacay-dev restart postgres ```

Frequently asked questions