createos

What this skill does

# CreateOS Platform Skills

> **Ship anything to production** — AI agents, APIs, backends, bots, MCP servers, frontends, webhooks, workers, and more.

## ⚠️ IMPORTANT: Authentication

### For AI Agents (MCP) - USE THIS
When connected via MCP (OpenClaw, MoltBot, ClawdBot, Claude), **NO API KEY NEEDED**.
The MCP server handles authentication automatically.

**MCP Endpoint:** `https://api-createos.nodeops.network/mcp`

Just call the tools directly:
```
CreateProject(...)
UploadDeploymentFiles(...)
ListProjects(...)
```

### For REST API (Scripts/External)
When calling REST endpoints directly (curl, Python requests, etc.):

```
X-Api-Key: <your-api-key>
Base URL: https://api-createos.nodeops.network
```

Get API key via MCP: `CreateAPIKey({name: "my-key", expiryAt: "2025-12-31T23:59:59Z"})`

## 🚀 Quick Start for MCP Agents

### Deploy Files Directly (Fastest)

```json
// 1. Create upload project
CreateProject({
  "uniqueName": "my-app",
  "displayName": "My App",
  "type": "upload",
  "source": {},
  "settings": {
    "runtime": "node:20",
    "port": 3000
  }
})

// 2. Upload files and deploy
UploadDeploymentFiles(project_id, {
  "files": [
    {"path": "package.json", "content": "{\"name\":\"app\",\"scripts\":{\"start\":\"node index.js\"}}"},
    {"path": "index.js", "content": "require('http').createServer((req,res)=>{res.end('Hello!')}).listen(3000)"}
  ]
})

// Result: https://my-app.createos.nodeops.network is live!
```

### Deploy from GitHub (Auto-deploy on push)

```json
// 1. Get GitHub installation ID
ListConnectedGithubAccounts()
// Returns: [{installationId: "12345", ...}]

// 2. Find repo ID
ListGithubRepositories("12345")
// Returns: [{id: "98765", fullName: "myorg/myrepo", ...}]

// 3. Create VCS project
CreateProject({
  "uniqueName": "my-app",
  "displayName": "My App", 
  "type": "vcs",
  "source": {
    "vcsName": "github",
    "vcsInstallationId": "12345",
    "vcsRepoId": "98765"
  },
  "settings": {
    "runtime": "node:20",
    "port": 3000,
    "installCommand": "npm install",
    "buildCommand": "npm run build",
    "runCommand": "npm start"
  }
})

// Auto-deploys on every git push!
```

### Deploy Docker Image

```json
// 1. Create image project
CreateProject({
  "uniqueName": "my-service",
  "displayName": "My Service",
  "type": "image",
  "source": {},
  "settings": {
    "port": 8080
  }
})

// 2. Deploy image
CreateDeployment(project_id, {
  "image": "nginx:latest"
})
```

## Table of Contents

1. [Introduction](#introduction)
2. [Core Skills Overview](#core-skills-overview)
3. [Project Management Skills](#project-management-skills)
4. [Deployment Skills](#deployment-skills)
5. [Environment Management Skills](#environment-management-skills)
6. [Domain & Routing Skills](#domain--routing-skills)
7. [GitHub Integration Skills](#github-integration-skills)
8. [Analytics & Monitoring Skills](#analytics--monitoring-skills)
9. [Security Skills](#security-skills)
10. [Organization Skills (Apps)](#organization-skills-apps)
11. [API Key Management Skills](#api-key-management-skills)
12. [Common Deployment Patterns](#common-deployment-patterns)
13. [Best Practices](#best-practices)
14. [Troubleshooting & Edge Cases](#troubleshooting--edge-cases)
15. [API Quick Reference](#api-quick-reference)

---

## Introduction

### What is CreateOS?

CreateOS is a cloud deployment platform designed for rapid shipping of any workload — from simple static sites to complex multi-agent AI systems. It provides:

- **Three deployment methods**: GitHub auto-deploy, Docker images, direct file upload
- **Multi-environment support**: Production, staging, development with isolated configs
- **Built-in CI/CD**: Automatic builds and deployments on git push
- **Custom domains**: SSL/TLS included, DNS verification
- **Real-time analytics**: Request metrics, error tracking, performance monitoring
- **Security scanning**: Vulnerability detection for deployments

### Target Users

| User Type | Primary Use Cases |
|-----------|-------------------|
| **AI/ML Engineers** | Deploy agents, MCP servers, RAG pipelines, LLM services |
| **Backend Developers** | Ship APIs, microservices, webhooks, workers |
| **Frontend Developers** | Deploy SPAs, SSR apps, static sites |
| **DevOps Engineers** | Manage environments, domains, scaling, monitoring |
| **Bot Developers** | Host Discord, Slack, Telegram bots |

### Supported Technologies

**Runtimes**: `node:18`, `node:20`, `node:22`, `python:3.11`, `python:3.12`, `golang:1.22`, `golang:1.25`, `rust:1.75`, `bun:1.1`, `bun:1.3`, `static`

**Frameworks**: `nextjs`, `reactjs-spa`, `reactjs-ssr`, `vuejs-spa`, `vuejs-ssr`, `nuxtjs`, `astro`, `remix`, `express`, `fastapi`, `flask`, `django`, `gin`, `fiber`, `actix`

---

## Core Skills Overview

### 🔌 MCP Tools Available (Direct Call - No Auth Needed)

When using CreateOS via MCP (OpenClaw, Claude, etc.), these tools are available directly:

**Projects:**
- `CreateProject` - Create new project (vcs, image, or upload type)
- `ListProjects` - List all projects
- `GetProject` - Get project details
- `UpdateProject` - Update project metadata
- `UpdateProjectSettings` - Update build/runtime settings
- `DeleteProject` - Delete project

**Deployments:**
- `CreateDeployment` - Deploy Docker image (image projects)
- `TriggerLatestDeployment` - Trigger build from GitHub (vcs projects)
- `UploadDeploymentFiles` - Upload files to deploy (upload projects)
- `UploadDeploymentBase64Files` - Upload binary files as base64
- `UploadDeploymentZip` - Upload zip archive
- `ListDeployments` - List all deployments
- `GetDeployment` - Get deployment status
- `GetBuildLogs` - View build logs
- `GetDeploymentLogs` - View runtime logs
- `RetriggerDeployment` - Retry failed deployment
- `CancelDeployment` - Cancel queued/building deployment
- `WakeupDeployment` - Wake sleeping deployment

**Environments:**
- `CreateProjectEnvironment` - Create environment (production, staging, etc.)
- `ListProjectEnvironments` - List environments
- `UpdateProjectEnvironment` - Update environment config
- `UpdateProjectEnvironmentEnvironmentVariables` - Set env vars
- `UpdateProjectEnvironmentResources` - Scale CPU/memory/replicas
- `AssignDeploymentToProjectEnvironment` - Assign deployment to env
- `DeleteProjectEnvironment` - Delete environment

**Domains:**
- `CreateDomain` - Add custom domain
- `ListDomains` - List domains
- `RefreshDomain` - Verify DNS
- `UpdateDomainEnvironment` - Assign domain to environment
- `DeleteDomain` - Remove domain

**GitHub:**
- `ListConnectedGithubAccounts` - Get connected GitHub accounts
- `ListGithubRepositories` - List accessible repos
- `ListGithubRepositoryBranches` - List branches

**Apps:**
- `CreateApp` - Create app to group projects
- `ListApps` - List apps
- `AddProjectsToApp` - Add projects to app

**User:**
- `GetCurrentUser` - Get user info
- `GetQuotas` - Check usage limits
- `GetSupportedProjectTypes` - List runtimes/frameworks

### Functional Skills

| Skill Category | Capabilities |
|----------------|--------------|
| **Project Management** | Create, configure, update, delete, transfer projects |
| **Deployment** | Build, deploy, rollback, wake, cancel deployments |
| **Environment Management** | Multi-env configs, env vars, resource scaling |
| **Domain Management** | Custom domains, SSL, DNS verification |
| **GitHub Integration** | Auto-deploy, branch management, repo access |
| **Analytics** | Request metrics, error rates, performance data |
| **Security** | Vulnerability scanning, API key management |
| **Organization** | Group projects into apps, manage services |

### Technical Skills

| Skill | Description |
|-------|-------------|
| **Authentication** | API key-based auth with expiry management |
| **Build AI** | Automatic build configuration detection |
| **Dockerfile Support** | Custom container builds |
| **Environment Isolation** | Separate configs per environment |
| **Resource Management** | CPU, memory, replica scaling |

---

## Project Management Skills