laravel-cloud

# Laravel Cloud API Skill

Wraps the entire [Laravel Cloud REST API](https://cloud.laravel.com/docs) in a single bash script.

## Setup

**Option 1 — Environment variable (preferred):**
```bash
export LARAVEL_CLOUD_API_TOKEN="your-token-here"
```

**Option 2 — Credentials file:**
```bash
mkdir -p ~/.openclaw/credentials/laravel-cloud
echo '{"token":"your-token-here"}' > ~/.openclaw/credentials/laravel-cloud/config.json
```

Generate your token at: **cloud.laravel.com → Settings → API Tokens**

## Usage

```bash
laravel-cloud <resource> <action> [args...]
```

## Quick Reference

| Resource | Actions |
|---|---|
| `apps` | list, get, create, update, delete |
| `envs` | list, get, create, update, delete, start, stop, metrics, logs, vars-add, vars-replace |
| `commands` | list, get, run |
| `deployments` | list, get, initiate |
| `domains` | list, get, create, update, delete, verify |
| `instances` | list, get, sizes, create, update, delete |
| `bg-processes` | list, get, create, update, delete |
| `databases` | clusters, cluster, cluster-create, cluster-update, cluster-delete, cluster-metrics, types, list, get, create, delete, snapshots, snapshot, snapshot-create, snapshot-delete, restore, dedicated |
| `caches` | list, get, types, create, update, delete, metrics |
| `buckets` | list, get, create, update, delete |
| `bucket-keys` | list, get, create, update, delete |
| `websockets` | list, get, create, update, delete, metrics |
| `ws-apps` | list, get, create, update, delete, metrics |
| `ips` | list |
| `org` | get |
| `regions` | list |

## Common Examples

```bash
# List all applications
laravel-cloud apps list

# Create an application (requires --repository)
laravel-cloud apps create --name "my-app" --region us-east-1 --repository owner/repo

# List environments for an app
laravel-cloud envs list <app-id>

# Create an environment
laravel-cloud envs create <app-id> --name "Production" --branch main

# Start / stop an environment
laravel-cloud envs start <env-id>
la...