Overview
The sunpeak push command uploads your built MCP Resources to the Sunpeak repository, making them available for deployment and version management.
sunpeak push [file] [options]
You must be logged in to use this command. Run sunpeak login first.
Prerequisites
Before pushing:
- Login - Run
sunpeak login to authenticate
- Build - Run
sunpeak build to create production bundles
How It Works
The push command:
- Finds all built resources in
dist/
- Reads metadata from
*.json files (name, title, description, mimeType)
- Uploads each resource to the Sunpeak repository
- Optionally assigns a tag for version management
Resource names must be unique within a repository. If you push a resource with a name that already exists, it will update the existing resource. The resource name is the name field in your .json file.
$ sunpeak push
Pushing 2 resource(s) to repository "myorg/my-app"...
✓ Pushed search (id: abc123)
✓ Pushed dashboard (id: def456)
✓ Successfully pushed 2 resource(s).
Arguments
| Argument | Description |
|---|
file | Optional JS file to push (e.g., dist/carousel.js). If not provided, pushes all resources from dist/ |
Options
| Option | Short | Description |
|---|
--repository <owner/repo> | -r | Repository name (defaults to git remote origin) |
--tag <name> | -t | Tag to assign to pushed resources (can be specified multiple times) |
--help | -h | Show help message |
Usage Examples
Push All Resources
Push all resources from the dist/ directory:
Push a Single Resource
Push a specific resource file:
sunpeak push dist/carousel.js
Push with Tag
Tag resources for versioning or environment management:
sunpeak push --tag v1.0.0
sunpeak push --tag staging
sunpeak push --tag v1.0.0 --tag latest
Specify Repository
Override the repository name (useful for CI/CD or monorepos):
sunpeak push --repository myorg/my-app
Combined Options
sunpeak push -r myorg/my-app -t staging
Repository Detection
By default, the repository name is detected from your git remote:
# Detected from git remote origin URL:
# - https://github.com/myorg/my-app.git → myorg/my-app
# - [email protected]:myorg/my-app.git → myorg/my-app
--repository.
Resource Discovery
The command discovers resources by finding all .js files in the dist directory:
dist/
├── search.js # Resource: search
├── search.json # Metadata for search resource
├── dashboard.js # Resource: dashboard
└── dashboard.json # Metadata for dashboard resource
.json file containing metadata like name, title, description, and uri. URIs are generated during sunpeak build—if a resource is missing its URI, push will fail with an error.
