Skip to content

syahiidkamil/Software-Engineer-AI-Agent-Atlas / .claude/skills/deploy

deploy

Flagged

Take a project from working locally to running in production, provider-agnostic — write the DEPLOY.md runbook, gate a release, deploy through the existing CI/CD pipeline, the provider's CLI or API, or exact printed steps, then health-check, smoke-test, and log it. Use when deploying, shipping, releasing, setting up hosting, rolling back, or reading production logs.

FileKindSize
SKILL.mdskill md7.8 KB
providers/coolify.mdmarkdown2.3 KB
providers/docker-compose-ssh.mdmarkdown1.2 KB
providers/fly.mdmarkdown1.2 KB
providers/netlify.mdmarkdown1.1 KB
providers/railway.mdmarkdown950 B
providers/vercel.mdmarkdown1.4 KB

providers/coolify.md

View on GitHub
# Coolify

Self-hosted (or Coolify Cloud) PaaS. Two routes: the REST API, or the `coolify` CLI.
Checked against Coolify v4.5 and coolify-cli v1.11 (2026-11); verify with `coolify --help`.

## Token
- Create it in the dashboard: Keys & Tokens -> API Tokens. On self-hosted, an admin first enables
  Settings -> Advanced -> API access.
- Abilities: deploying needs `deploy` (or `root`); `write` does **not** include deploy. Reading
  logs over the API needs `read:sensitive`. Prefer `deploy` plus an expiry.
- The user stores it once (global): `node .claude/scripts/secrets.cjs set COOLIFY_API_TOKEN`, and
  the base URL as `COOLIFY_URL`. App UUIDs go in `DEPLOY.md` (they are not secrets).

## Deploy (REST API, works anywhere with curl)
`POST {COOLIFY_URL}/api/v1/deploy?uuid=<app-uuid>&force=false`, header `Authorization: Bearer <token>`.
Since v4.2 this is POST; GET returns 405.
```
node .claude/scripts/secrets.cjs run <project> -- sh -c 'curl -fsS -X POST -H "Authorization: Bearer $COOLIFY_API_TOKEN" "$COOLIFY_URL/api/v1/deploy?uuid=<app-uuid>&force=false"'
```
The response lists `deployments[].deployment_uuid`. `tag=<tag>` deploys every resource with a tag.

## Deploy (CLI)
- Install: `brew install coollabsio/coolify-cli/coolify-cli`, or the install script in the
  coollabsio/coolify-cli README.
- One-time context with the token: the CLI has no token env var, so the user runs
  `coolify context add -d <name> <url> <token>` **in their own terminal**, not through `!` (the
  command text would land in the transcript).
- Deploy: `coolify deploy uuid <app-uuid>` (`--force` rebuilds without cache); watch with
  `coolify deploy list` / `coolify deploy get <deployment-uuid>`.

## Environments
Staging is a separate resource (its own UUID) or a separate Coolify environment. PR previews:
`--pull-request-id <id>` (CLI) or `pr=<id>` (API).

## Logs
`coolify app logs <app-uuid> -n 100`; build logs: `coolify app deployments logs <app-uuid> [deployment-uuid]`.

## Rollback
No CLI command. API (v4.3+): `GET /api/v1/applications/<uuid>/rollback-images`, then
`POST /api/v1/applications/<uuid>/rollback` with `{"commit":"<tag>"}` (needs `deploy`). Or the
dashboard's Rollback tab.

## Env vars on the server
`coolify app env sync <app-uuid> --file <file>` (adds and updates, never deletes) or set them in
the dashboard. Do not sync a file holding production values from chat; the user does it.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall