convez.ai
SkillDevOps & InfraestruturaIntermediário
itorz7

Coolify CLI Skill

itorz7/coolify-cli-skills

Implante apps e gerencie infraestrutura via Coolify CLI com agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que ensina agentes de IA a usar a Coolify CLI para implantar aplicações, gerenciar bancos de dados e serviços, configurar servidores e transmitir logs em Coolify Cloud ou instâncias auto-hospedadas. Fornece modelo mental correto e referências precisas de comandos, eliminando alucinações de sintaxe.

Instalação

$npx convez-ai itorz7/coolify-cli-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar deploy de aplicações em Coolify Cloud ou self-hosted
  • Gerenciar bancos de dados e serviços one-click via agente de IA
  • Configurar servidores, variáveis de ambiente e backups programados
  • Monitorar logs de deployment em tempo real através de agente

Veredito

Skill bem estruturada que soluciona um problema real: agentes que alucinam sintaxe Coolify. A abordagem modular (SKILL.md + references específicas) é eficiente e o suporte a múltiplos agentes amplia utilidade. Recomendado para times que automatizam infraestrutura com IA.

README

A tradução para o português deste README ainda está na fila.

coolify-cli skill

An Agent Skill that teaches your coding agent how to drive the Coolify CLI — deploy apps, manage databases & one-click services, configure servers, sync env vars, schedule backups, and stream deployment logs on Coolify Cloud or any self-hosted instance.

The skill wraps the official coolify-cli and is distilled from its upstream llms-full.txt — the full machine-readable command catalog.


Why a skill?

Without it, an agent guesses Coolify command syntax from stale training data. With it, the agent gets the right mental model (everything is addressed by UUID, you need both a project- and server-UUID to create resources, sensitive fields are hidden by default) plus command-accurate references it loads only when needed — so it stops hallucinating flags and starts shipping.

coolify <noun> <verb> [--flags]
   nouns: context · server · project · app · database · service · deploy · private-key · github · teams

What's inside

coolify-cli/
├── SKILL.md                  # entry point: mental model, auth, common workflows, command map
└── references/
    ├── context.md            # contexts & authentication (cloud + self-hosted, multi-instance)
    ├── apps.md               # applications: 5 create modes, lifecycle, logs, env, storage, previews
    ├── databases.md          # databases: 8 engines, credentials, backups & S3 retention
    ├── services.md           # one-click service stacks
    ├── server.md             # servers, projects, private keys, GitHub Apps, teams
    ├── deploy.md             # trigger / batch / watch / cancel deployments
    └── llms-full.txt         # upstream full command catalog (every command + flag)

The agent reads SKILL.md first, then pulls in the one reference file it needs for exact flags — keeping context small.


Install

Claude Code

Personal (all projects on your machine):

git clone https://github.com/itorz7/coolify-cli-skills.git
cp -r coolify-cli-skills/coolify-cli ~/.claude/skills/coolify-cli

Project (commit it to a repo, shared with your team):

git clone https://github.com/itorz7/coolify-cli-skills.git
cp -r coolify-cli-skills/coolify-cli .claude/skills/coolify-cli

That's it. Claude Code auto-discovers any SKILL.md under ~/.claude/skills/ or <project>/.claude/skills/. Verify with /skills (or just ask Claude "do you see the coolify-cli skill?").

One-liner (personal)

git clone --depth=1 https://github.com/itorz7/coolify-cli-skills.git /tmp/ccs && \
mkdir -p ~/.claude/skills && cp -r /tmp/ccs/coolify-cli ~/.claude/skills/ && rm -rf /tmp/ccs

Other agents

The skill is plain Markdown, so any agent that supports the Skills format works:

AgentWhere to put coolify-cli/
Claude Code~/.claude/skills/ or <project>/.claude/skills/
Codex / Copilot CLIdrop the folder where your agent loads skills, or point it at coolify-cli/SKILL.md
Anything elsefeed coolify-cli/SKILL.md (and references/) as context, or hand it references/llms-full.txt directly

Quick start (after install)

Tell your agent something like:

"Deploy my-api to Coolify and stream the logs." "Create a postgres database in project X and give me the connection string." "Sync .env.production into the web app as build-time vars."

It will reach for the skill automatically. The first thing it should do is confirm which instance it's pointed at:

coolify context list      # which instances are configured, which is default
coolify context verify    # check the current context's connection + auth

Need the CLI itself?

curl -fsSL https://raw.githubusercontent.com/coollabsio/coolify-cli/main/scripts/install.sh | bash   # Linux/macOS
brew install coollabsio/coolify-cli/coolify-cli                                                      # Homebrew
go install github.com/coollabsio/coolify-cli/coolify@latest                                          # Go
irm https://raw.githubusercontent.com/coollabsio/coolify-cli/main/scripts/install.ps1 | iex          # Windows

Get an API token from your Coolify dashboard at /security/api-tokens, then:

coolify context set-token cloud <token>                     # Coolify Cloud
coolify context add -d prod https://coolify.example.com <token>   # self-hosted (default)

Updating

cd coolify-cli-skills && git pull
cp -r coolify-cli ~/.claude/skills/coolify-cli      # re-copy over the installed copy

Credits & references

This skill is an independent packaging of public Coolify CLI documentation for use with coding agents. Coolify and the Coolify CLI are projects of coollabsio.

License

MIT

Ver o original no GitHub

Bom para

Relacionados