Cloudkite

Catch the wind. Ship to Laravel Cloud.

Portable skill and agent instructions for automating Laravel Cloud with the official cloud CLI. Drop them into your AI coding agent's skill/agent directories and get consistent, safe Cloud ops for any Laravel app.

What it is

Cloudkite is a small, copy-paste pack:

Piece	Purpose
Skill (skill/)	How to use the cloud CLI: conventions, first ship, env vars, queues, failure handling
Agent (agent/)	System-prompt style playbooks for a dedicated Laravel Cloud ops agent
Checklists	Multi-step ops lists + a first-ship production checklist
Ensure script	Installs the Cloud CLI into a portable bin dir and verifies auth

It is not a hosted service and not a fork of the Cloud CLI — it documents and operationalizes the official tooling so agents (and humans) ship the same way every time.

Requirements

• Laravel Cloud account
• Laravel Cloud CLI (cloud v0.5+)
• A Laravel Cloud API token (dashboard → Settings → API — not a GitHub token)
• Optional: GitHub CLI (gh) for linking a repo to the Cloud app
• A Laravel application you intend to deploy

Install

Clone or copy this repository, then place the skill and agent where your AI agent loads instructions from.

git clone https://github.com/lonnylot/cloudkite.git

Generic layout

Many agents load skills and agent defs from a project-local or user-local skills directory. A common pattern:

<your-agent-config>/
  skills/
    laravel-cloud/          ← copy skill/ contents here
      SKILL.md
      references/
      scripts/
  agents/
    laravel-cloud.md        ← copy agent/laravel-cloud.md here

Examples of paths people use:

• Project: .agents/skills/laravel-cloud/, .agents/agents/laravel-cloud.md
• User home: ~/.config/agents/skills/laravel-cloud/
• Cursor-style: .cursor/skills/laravel-cloud/ (adapt to your tool)

Point the agent at the skill name laravel-cloud (see frontmatter in skill/SKILL.md). Adjust directory names to match whatever your agent documents for skill discovery.

Cloud CLI helper

chmod +x skill/scripts/ensure-cloud-cli.sh
./skill/scripts/ensure-cloud-cli.sh

By default the script installs into $HOME/bin (or /usr/local/bin if writable). Overrides:

export CLOUD_CLI_VERSION=v0.5.0
export CLOUD_CLI_INSTALL_DIR="$HOME/bin"
export PATH="$HOME/bin:$PATH"

Authenticate once:

cloud auth:token --add -n

What's included

cloudkite/
  README.md
  LICENSE
  docs/hero.jpg
  skill/
    SKILL.md
    references/
      checklists.md           # multi-step Cloud ops
      first-ship-checklist.md # first production ship / audit
    scripts/
      ensure-cloud-cli.sh
  agent/
    laravel-cloud.md

Quick start (human or agent)

cd /path/to/your-laravel-app
export PATH="$HOME/bin:$PATH"
cloud ship -n --name=my-app --database=postgres --database-preset=dev
cloud deploy:monitor -n

Then walk skill/references/first-ship-checklist.md for cache, storage, workers, env vars, and smoke tests.

Safety notes

• Confirm deletes — applications, environments, databases, caches, buckets, domains
• Never print secrets — mask API tokens, env dumps, and third-party keys in agent output
• Prefer env var --action=set / append over full --action=replace
• Always use non-interactive -n; never hang on prompts
• Discover flags with cloud <command> -h — do not invent options
• If a Cloud command fails twice after one fix attempt, stop and ask the user

Docs

• Laravel Cloud product docs: https://cloud.laravel.com/docs
• LLM-oriented Cloud docs index: https://cloud.laravel.com/docs/llms.txt
• Cloud CLI releases: https://github.com/laravel/cloud-cli/releases

License

MIT