Skill

laravel-forge

Complete Laravel Forge management via curl - servers, sites, deployments, databases, SSL, SSH keys, firewall, jobs, daemons, and more.

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/laravel-forge:laravel-forge

User invocable

Model invocable

Inline context

Default effort

Tool Access

This skill is limited to the following tools:

Bash(curl:*)

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Manage Laravel Forge infrastructure using curl. No dependencies required - just curl (available on all systems).

SKILL.md

455 lines · ~3.4k tokens

Stats

Stars0

MaintenanceUnmaintained

Last CommitJan 7, 2026

Actions

View Source View Plugin View on GitHub View README

Stats

Actions

Laravel Forge Control

Manage Laravel Forge infrastructure using curl. No dependencies required - just curl (available on all systems).

Setup

User must set environment variables:

export FORGE_API_TOKEN="your-token"      # From https://forge.laravel.com/profile/api
export FORGE_ORG_SLUG="your-org-slug"    # Your organization slug from Forge URL

API Endpoints Reference

Base URL: https://forge.laravel.com/api

All requests require header: Authorization: Bearer $FORGE_API_TOKEN

Servers

List all servers:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers"

Get server details:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}"

Reboot server:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"action":"reboot"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/actions"

Restart Nginx:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"action":"restart"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/nginx-action"

Restart PHP-FPM:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"action":"restart","version":"8.2"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/php-action"

Restart MySQL:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"action":"restart"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/mysql-action"

Sites

List all sites:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites"

Get site details:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}"

Create site:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","project_type":"laravel","directory":"/public"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites"

Delete site:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}"

Get .env file:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/env"

Update .env file:

curl -s -X PUT -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"APP_ENV=production\nAPP_DEBUG=false"}' \
  "https://forge.laravel.com/api/sites/{site_id}/env"

Get Nginx config:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/nginx"

Update Nginx config:

curl -s -X PUT -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"server { ... }"}' \
  "https://forge.laravel.com/api/sites/{site_id}/nginx"

Get site logs:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/logs?type=error"

Deployments

Trigger deployment:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/deployments"

List deployments:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/deployments"

Get deployment details:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/deployments/{deployment_id}"

Get deployment output:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/deployments/{deployment_id}/output"

Get deploy script:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/deployment-script"

Update deploy script:

curl -s -X PUT -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"cd /home/forge/site\ngit pull\ncomposer install --no-dev"}' \
  "https://forge.laravel.com/api/sites/{site_id}/deployment-script"

Databases

List databases:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/schemas"

Create database:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"name":"my_database"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/schemas"

Delete database:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/schemas/{database_id}"

List database users:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/users"

Create database user:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"dbuser","password":"secret123","databases":[1,2]}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/users"

Delete database user:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/database/users/{user_id}"

Domains & SSL

List domains:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/domains"

Add domain:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"name":"www.example.com"}' \
  "https://forge.laravel.com/api/sites/{site_id}/domains"

Delete domain:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/domains/{domain_id}"

Get SSL certificate status:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/domains/{domain_id}/certificate"

Install Let's Encrypt SSL:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"type":"letsencrypt"}' \
  "https://forge.laravel.com/api/sites/{site_id}/domains/{domain_id}/certificate"

Delete SSL certificate:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/sites/{site_id}/domains/{domain_id}/certificate"

SSH Keys

List SSH keys:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/ssh-keys"

Add SSH key:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Key","key":"ssh-rsa AAAA..."}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/ssh-keys"

Delete SSH key:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/ssh-keys/{key_id}"

Firewall Rules

List firewall rules:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/firewall-rules"

Add firewall rule:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Custom Port","port":"8080","ip_address":null}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/firewall-rules"

Add firewall rule with IP restriction:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"MySQL Restricted","port":"3306","ip_address":"10.0.0.1"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/firewall-rules"

Delete firewall rule:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/firewall-rules/{rule_id}"

Scheduled Jobs (Cron)

List scheduled jobs:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/scheduled-jobs"

Create scheduled job:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"php artisan schedule:run","frequency":"minutely","user":"forge"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/scheduled-jobs"

Frequency options: minutely, hourly, nightly, weekly, monthly, custom

Create custom cron job:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"php artisan backup:run","frequency":"custom","cron":"0 2 * * *","user":"forge"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/scheduled-jobs"

Delete scheduled job:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/scheduled-jobs/{job_id}"

Daemons (Background Processes)

List daemons:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/background-processes"

Create daemon:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"php artisan queue:work","user":"forge","processes":3}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/background-processes"

Delete daemon:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/background-processes/{daemon_id}"

Restart daemon:

curl -s -X PUT -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"action":"restart"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/background-processes/{daemon_id}"

Get daemon logs:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/background-processes/{daemon_id}/log"

Redirect Rules

List redirects:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/redirect-rules"

Create redirect (301 permanent):

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"/old-page","to":"/new-page","type":"permanent"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/redirect-rules"

Create redirect (302 temporary):

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"/promo","to":"/sale","type":"temporary"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/redirect-rules"

Delete redirect:

curl -s -X DELETE -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/redirect-rules/{redirect_id}"

Command Execution

Run command on site:

curl -s -X POST -H "Authorization: Bearer $FORGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"php artisan migrate --force"}' \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/commands"

List command history:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/commands"

Get command output:

curl -s -H "Authorization: Bearer $FORGE_API_TOKEN" \
  "https://forge.laravel.com/api/orgs/$FORGE_ORG_SLUG/servers/{server_id}/sites/{site_id}/commands/{command_id}/output"

Usage Notes

Always list first - Use list commands to get IDs before other operations
Confirm destructive actions - Ask user before delete/reboot operations
Replace placeholders - Replace {server_id}, {site_id}, etc. with actual IDs
Check response - API returns JSON with operation status

API Reference

Official docs: https://forge.laravel.com/docs/api-reference/introduction

laravel-forge

Invocation

Tool Access

Context Preview

SKILL.md

laravel-forge

Invocation

Tool Access

Context Preview

SKILL.md

Laravel Forge Control

Setup

API Endpoints Reference

Servers

Sites

Deployments

Databases

Domains & SSL

SSH Keys

Firewall Rules

Scheduled Jobs (Cron)

Daemons (Background Processes)

Redirect Rules

Command Execution

Usage Notes

API Reference

Similar Skills

Laravel Forge Control

Setup

API Endpoints Reference

Servers

Sites

Deployments

Databases

Domains & SSL

SSH Keys

Firewall Rules

Scheduled Jobs (Cron)

Daemons (Background Processes)

Redirect Rules

Command Execution

Usage Notes

API Reference

Similar Skills