@pixelcloud/cli

Command-line tool for managing EdgeRunners game servers. Binary: pixel.

Install

npm install -g @pixelcloud/cli

Requires Node.js >= 18.

Quick Start

# Authenticate (opens browser)
pixel auth login

# Search for a game image
pixel search image "minecraft"

# Create a server
pixel create --image-id 1 --plan 1

# Check status
pixel status

# Let AI do it for you
pixel prompt "create a minecraft server with 4GB RAM"

Commands

| Command | Description | | -------------------------------------- | --------------------------------- | | pixel auth login | Authenticate via device code flow | | pixel auth logout | Remove stored credentials | | pixel auth set-api-url <url> | Set API base URL | | pixel auth set-web-url <url> | Set dashboard URL | | pixel create | Create a game server | | pixel start --server-id <id> | Start a server | | pixel stop --server-id <id> | Stop a server | | pixel restart --server-id <id> | Graceful restart | | pixel force-restart --server-id <id> | Force restart (pod delete) | | pixel delete --server-id <id> | Delete a server | | pixel search image [keywords] | Search game images | | pixel prompt <message> | AI assistant (natural language) | | pixel status | List all servers | | pixel skill | Install skill for AI agents |

Use --json on any command for machine-readable output. Use --help on any command for full usage.

Configuration

Config is stored in ~/.config/pixelcloud/config.json.

Environment variable overrides:

| Variable | Description | | -------------------- | ---------------------------------- | | PIXELCLOUD_TOKEN | API token (overrides stored token) | | PIXELCLOUD_API_URL | API base URL | | PIXELCLOUD_WEB_URL | Web dashboard URL |

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run locally
node dist/index.js --help

See docs/cli.md for architecture details.