Serve & Pro CLI

Universal local development and web serving orchestrator with lightning-fast project management.

serve is a local-first, zero-cloud developer CLI built with standalone native binaries. It detects your project, selects the optimal adapter, verifies required runtimes, chooses a free port, launches and monitors your dev process, and displays verified URLs.

Installation

npm install -g serve-dev-cli

Or run directly without installation:

npx serve-dev-cli .

The 4 Permanent Global Commands

The package provides four global commands:

• serve: Primary universal dev server and web serving command
• servecc: Secondary / alternate command for the same Serve functionality
• pro: Primary local project management and navigation command
• procc: Secondary / alternate command for the same Pro functionality

Universal Project Execution (serve)

# Serve current directory (auto-detects framework or static files)
serve .

# Detect framework and readiness
serve detect
serve doctor
serve deps

# Monorepo discovery and project targeting
serve projects
serve . --project web

# Run production build or preview
serve build
serve preview

# Benchmark HTTP throughput and latency
serve benchmark . -c 20 -n 1000

# Force static file serving (bypasses framework dev commands)
serve --static ./dist

Process Management

serve ps                    # List active Serve processes
serve ports                 # Show allocated ports
serve logs <name> --tail 50 # View server logs
serve restart <name>        # Gracefully restart a process
serve stop <name>           # Stop a running process

Project Management (pro)

pro ls                      # List all registered projects with health and frameworks
pro set ./my-app            # Register a project
pro serve my-app            # Launch a registered project
pro detect my-app           # Inspect project details
pro doctor my-app           # Run diagnostics
pro stop my-app             # Stop a project

Supported Ecosystems

• Node.js: Next.js, Vite, Nuxt, Astro, SvelteKit, Remix, Angular, Express, Fastify, NestJS, Gatsby
• Python: Django, FastAPI, Flask, Tornado
• Go: Gin, Echo, Fiber, Standard library
• Rust: Axum, Actix Web, Rocket, WebAssembly
• PHP: Laravel, Symfony, Native PHP
• Ruby: Ruby on Rails, Sinatra
• JVM: Spring Boot (Maven & Gradle)
• .NET: ASP.NET Core
• Elixir: Phoenix Framework
• Static: Pure HTML, CSS, JavaScript, WebAssembly

Philosophy

• Local-First: Zero cloud dependencies, zero external accounts.
• Deterministic: Explicit adapters and deterministic command construction.
• Zero Telemetry: No tracking, phone-homes, or analytics.
• Safe Health Probing: Verifies TCP and HTTP response before reporting readiness.

License

MIT © 2026 Serve & Pro Contributors