Developer tools

PixelCloud CLI & API

Manage game servers from your terminal, automation, or AI coding agent.

Install

$npm install -g @pixelcloud/cli

Requires Node.js >= 18

Quick Start

pixel auth login

Authenticate via device code flow (opens browser)

pixel search image "minecraft"

Search for available game server images

pixel create --image-id 1 --plan 1

Create a new game server

pixel status

List all your servers

pixel prompt "create a minecraft server"

Let AI handle it with natural language

HTTPS · JSON v1

HTTP API

Control selected servers from scripts and integrations with a versioned JSON API and a server-scoped key.

Manage API keys

Base URL

https://api.edgerunners.cn/v1

Authentication

Authorization: Bearer egrs_sk_…

Your first request

curl https://api.edgerunners.cn/v1/servers \
  -H "Authorization: Bearer $PIXELCLOUD_API_KEY"

GET/servers

List servers this key can access

GET/servers/:id

Read one permitted server

POST/servers/:id/start

Start a stopped server

POST/servers/:id/stop

Stop a running server

POST/servers/:id/restart

Gracefully restart a server

POST/servers/:id/force-restart

Force a stuck server pod to restart

A key receives a not-found response for every server outside its selected scope.

Full API reference

Agent Skill

Teach your AI coding agent how to manage game servers with the PixelCloud CLI or scoped HTTP API.

Install via Skills CLI

Works with Claude Code, Copilot, Cursor, Codex, and 40+ other AI coding agents via the open skills ecosystem.

$npx skills add skyquakers/pixelcloud-skills

Manual Copy

Or copy this snippet into your agent's system prompt or skill configuration.

You can manage PixelCloud game servers with the `pixel` CLI or its scoped HTTP API.

When PIXELCLOUD_API_KEY is available, use https://api.edgerunners.cn/v1 for existing server status and lifecycle actions. Send the key only as an Authorization: Bearer header. The key can access only the servers selected in the dashboard.

Available commands:
  pixel auth login                        # authenticate (opens browser)
  pixel create --image-id <id> --plan <id> [--name <n>] [--env K=V...]
  pixel start --server-id <id>
  pixel stop --server-id <id>
  pixel restart --server-id <id>
  pixel force-restart --server-id <id>
  pixel delete --server-id <id> [--yes]
  pixel search image [keywords]           # search game images
  pixel prompt <message>                  # AI assistant
  pixel status                            # list all servers
  pixel status --server-id <id>           # details of one server

Add --json to any command for machine-readable output.
Environment variables: PIXELCLOUD_TOKEN, PIXELCLOUD_API_KEY, PIXELCLOUD_API_URL, PIXELCLOUD_WEB_URL

Get Started GitHub