# coolify-manager

A skill for running Coolify through its official CLI and API: service status, logs, containers, SSL, WordPress fixes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 502 installs · ★ 17
- Author: ajmcclary
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ajmcclary/Coolify-Manager/tree/HEAD/SKILL.md
- Updated: 2025-10-26
- HTML: https://affpapa.org/en/nevibecode/skills/coolify-manager

## What it does

This skill hands the agent a set of workflows for Coolify. It checks service and application status, reads logs, starts and stops containers and databases, edits environment variables, and triggers deployments. When the CLI can't do something, the skill falls back to direct REST API calls.

Two scripts ship with it. `scripts/install_coolify_cli.sh` puts the CLI in `~/.local/bin/coolify`, and `scripts/check_health.sh` prints the CLI version, configured contexts, connection status, and available resources. Reference files cover API endpoints and WordPress repairs. You need access to a Coolify instance and an API token from the dashboard at `/security/api-tokens`, plus the instance URL. No token means no context, and the skill stalls at step one.

Common breakages are handled step by step. If a site goes down after an `.htaccess` edit, the skill reads the file under `/var/www/html/`, finds the offending line, and removes it. PHP limits go up with lines like `php_value max_input_vars 3000`, no `=` sign. When Site Health reports the REST API as unavailable but the site works, the skill tests the endpoint with `curl` and tells a false positive from a real failure.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/coolify-manager/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/coolify-manager/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/coolify-manager/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/coolify-manager/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ajmcclary/Coolify-Manager coolify-manager
```

2. **Manually: put the files in place**
- File: `.github/skills/coolify-manager/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ajmcclary/Coolify-Manager
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/coolify-manager/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ajmcclary/Coolify-Manager --skill coolify-manager -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ajmcclary/Coolify-Manager/tree/HEAD/SKILL.md

## When to use it
- find out why a Coolify-hosted site stopped responding
- remove a broken line from `.htaccess` and bring WordPress back
- raise PHP limits for uploads and memory
- tell a false REST API warning from a real one
- read container logs and service status by UUID

## Example prompts
- The site on Coolify returns 500 after an .htaccess edit — fix it
- Check the service status and show me the last container logs
- Raise the PHP upload limits on this WordPress install

## Similar
- [coolify](https://affpapa.org/en/nevibecode/skills/coolify.md) — skill · 360 installs
- [docker-destructive-guardrails](https://affpapa.org/en/nevibecode/skills/docker-destructive-guardrails.md) — skill · 1000 installs
- [devops-deployment](https://affpapa.org/en/nevibecode/skills/devops-deployment.md) — skill · 1600 installs
- [adding-docker](https://affpapa.org/en/nevibecode/skills/adding-docker.md) — skill · 398 installs
- [wp-env](https://affpapa.org/en/nevibecode/skills/wp-env.md) — skill · 679 installs
- [containerize-application](https://affpapa.org/en/nevibecode/commands/containerize-application.md) — command · 1200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md