laravel-forge

# Laravel Forge API Skill

Wraps the [Laravel Forge API](https://forge.laravel.com/docs/api-reference/introduction) in a single bash script. Organization-scoped, JSON:API format.

## Setup

**Option 1 — Environment variables:**
```bash
export LARAVEL_FORGE_API_TOKEN="your-token-here"
export LARAVEL_FORGE_ORG="your-default-org-slug"
```

**Option 2 — Credentials file (recommended):**
```bash
mkdir -p ~/.openclaw/credentials/laravel-forge
echo '{"token":"your-token-here","org":"your-default-org-slug"}' > ~/.openclaw/credentials/laravel-forge/config.json
```

Generate your token at: **forge.laravel.com → Profile → API**

The `org` field is optional — if omitted, the CLI auto-detects your first organization. Set it explicitly if you have multiple orgs or want to skip the extra API call. You can also override per-command with `--org`.

## Usage

```bash
laravel-forge <resource> <action> [args...] [--org ORG]
```

All commands support `--org ORG_SLUG` to override the default organization.

## Resources Overview

| Resource | Description |
|---|---|
| `user` | Current user info |
| `organizations` | List/get organizations |
| `providers` | Cloud provider info (regions, sizes) |
| `servers` | Server management (create, delete, events, archives) |
| `services` | Control services (nginx, mysql, postgres, redis, php, supervisor) |
| `php` | PHP version management & configuration (cli/fpm/pool configs, opcache) |
| `background-processes` | Background processes (supervisor daemons) |
| `firewall` | Firewall rules |
| `jobs` | Scheduled jobs (server-scoped and site-scoped) |
| `keys` | SSH keys |
| `databases` | Database schemas |
| `db-users` | Database users |
| `backups` | Backup configurations & instances |
| `monitors` | Server monitors (CPU, memory, disk) |
| `nginx-templates` | Nginx templates |
| `logs` | Server logs |
| `sites` | Site management |
| `domains` | Per-site domain management |
| `composer-credentials` | Per-site Composer credentials |
| `npm-credentials` | P...