Skip to main content

​
Overview

The sunpeak CLI commands support a complete development lifecycle, from project creation to production builds. This page explains how the commands work together.

​
Development Lifecycle

​
1. Create

Install sunpeak globally: 
pnpm add -g sunpeak
Then start a new project: 
sunpeak new
This scaffolds a complete sunpeak project with all the configuration and structure you need.

​
2. Develop

Run the development server with hot reload: 
sunpeak dev
This starts:
  • The inspector at http://localhost:3000 for local development
  • An MCP server at http://localhost:8000 for testing with real MCP clients
  • A sandbox proxy for cross-origin iframe isolation (matching production host behavior)
Both the inspector and MCP server support Hot Module Reload, letting you iterate quickly on your App UI.

​
3. Build

Create production-ready bundles: 
sunpeak build
This compiles and optimizes your Resources, Tools, and optional server entry for production.

​
4. Start

Start the production MCP server: 
sunpeak start
This loads your compiled tools (with real handlers and Zod schemas), serves pre-built resource HTML, and runs your auth() function if present. See the Deployment Guide for details on publishing to ChatGPT.

​
Dive Deeper

CLI API Reference

Detailed documentation for all CLI commands and options.