Skip to main content

Overview

The sunpeak CLI provides commands for managing ChatGPT Apps. It includes a client for the sunpeak Resource Repository (ECR for ChatGPT Apps). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server:

Version Tagging

Tag your app builds with version numbers and environment names (like v1.0.0 and prod).

Centralized Storage

push built Apps to a central location accessible by your team and CI/CD pipelines.

Flexible Deployment

pull built Apps to be run in different environments (staging, production, etc.).

Commands

The CLI includes commands for both local development and repository operations:

Local Development

CommandDescription
sunpeak newCreate a new sunpeak project
sunpeak devStart the development server
sunpeak buildBuild production bundles
sunpeak mcpStart the MCP server for testing

Repository Operations

CommandDescription
sunpeak loginAuthenticate with your Sunpeak account
sunpeak logoutLog out and clear stored credentials
sunpeak pushPush built resources to the repository
sunpeak pullPull resources by tag from the repository
sunpeak deployDeploy resources to production
The CLI is included when you install sunpeak. No separate installation required!

Why decouple Apps & MCP servers?

ChatGPT Apps are built on MCP servers, but your UI resources don’t need to live alongside your server code. Decoupling them provides:
  1. Generic MCP servers: Keep your production MCP server largely client agnostic
  2. Remove JavaScript: If your server is in Python (or any other language), keep React and JavaScript out of your server.
  3. Independent lifecycles: Clearly indicate which code changes and version tags require ChatGPT App submission reviews and which are entirely MCP server-side
  4. Team collaboration: Designers and frontend devs can push UI changes without touching server infrastructure and vice versa

Dive Deeper

CLI API Reference

Detailed documentation for all CLI commands.