--- description: How this repository deploys to Ghaym Cloud, with a link to the docs page for each rule. globs: alwaysApply: true --- # Ghaym Cloud Save as `.cursor/rules/ghaym.mdc`. Canonical version: https://ghaym.me/integrations/ghaym.cursor.mdc This repository deploys to Ghaym Cloud. Each rule links the page of the docs that explains it; read that page before acting on the rule. - Production branch: `[main]` - Service name in Ghaym: `[web]` ## Rules - Sign-up needs a person. Deploying opens once Ghaym approves the account. If there is no account, say so and stop. [Set up a coding agent](https://ghaym.me/en/docs/agents) - Use the CLI, not hand-written API calls. [Install the CLI and sign in](https://ghaym.me/en/docs/install-the-cli) - The CLI uses the login of whoever runs it. If `ghaym whoami` fails, ask them to run `ghaym login` in their own terminal; never ask them to paste a key into the chat. [Set up a coding agent](https://ghaym.me/en/docs/agents) - Learn every command and flag with `ghaym help all --json`. [CLI reference](https://ghaym.me/en/docs/cli) - A push to the branch a service tracks builds and deploys it, in every environment that tracks that branch. [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) - A deploy has worked only when its build log says so: `ghaym cloud deployments logs `. [Builds and deploys](https://ghaym.me/en/docs/builds) - Listen on `0.0.0.0`, on the port in `PORT`. An app bound to localhost fails the readiness check, and its deploy fails. [Builds and deploys](https://ghaym.me/en/docs/builds) - Set the project up with `ghaym cloud git install`, then `ghaym cloud projects create --name `, then `ghaym cloud services create --project --type git --repo --size --site `. `ghaym cloud regions list` names the sites. [Deploy your first service](https://ghaym.me/en/docs/getting-started) - Try a change away from production with `ghaym cloud environments create --project --name --branch `, then push to that branch. [Deploy a branch to its own environment](https://ghaym.me/en/docs/branch-environments) - Undo a bad deploy with `ghaym cloud deployments rollback `. [Roll back a deploy](https://ghaym.me/en/docs/rollback) - Variables live in Ghaym, set with `ghaym cloud vars set`, not in a committed config file. [Set variables and secrets](https://ghaym.me/en/docs/variables) - Every change is staged, variables included, and moves only with `ghaym cloud changes apply`, or `--apply` on the same call. Applying a variable, a bucket connection, the branch or a build setting deploys the service. [Staged changes](https://ghaym.me/en/docs/staged-changes) - Try a change with `--dry-run` first: every command that changes something takes it and then changes nothing. [CLI reference](https://ghaym.me/en/docs/cli) - A command that needs approval exits with `6` and an approval id. Run `ghaym cloud approvals wait ` instead of retrying. [Supervise a coding agent](https://ghaym.me/en/docs/agent-approvals) - An API error's `docs` link points to the page for its `type`. Follow it before retrying. [API errors](https://ghaym.me/en/docs/errors) - Prices depend on the site. Read them with `ghaym cloud regions sizes `. [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) - Polling keeps a service awake. Services outside production sleep when idle. [Sleep and wake](https://ghaym.me/en/docs/sleep) The HTTP API: [API keys and scopes](https://ghaym.me/en/docs/api-keys).