convez.ai
Agente
AkaLab-Tech

coolify-integration

AkaLab-Tech/coolify-integration

Ver no GitHub
InicialPluginScore · de 0 a 100

Coolify VPS deployment integration for atelier agents (optional Claude Code plugin)

Instalação

$npx convez-ai AkaLab-Tech/coolify-integration

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
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 semanas
Versão
v0.4.2
Issues abertas
6
Contribuidores
1

README

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

coolify-integration

Optional, standalone Claude Code plugin that lets atelier agents operate a Coolify VPS: validate deployments, read logs, trigger deploys, set environment variables, and create or delete applications — all via Coolify's v1 REST API.

It is independent of atelier; install it only if you deploy with Coolify.

Install

/plugin marketplace add AkaLab-Tech/claude-plugins
/plugin install coolify-integration@akalab-tech

Setup

In Coolify, create an API token (Settings → API / Keys & Tokens) with the read, deploy, and write scopes (avoid root unless you need it).

Setup has two parts: a machine-wide part (link the CLI onto PATH, grant the allowlist) and a per-project part (the token + URL). Auth is per project so one operator can deploy different projects to different Coolify instances.

With atelier — pick it during install.sh, or run any time:

/atelier:setup-coolify

Standalone — configure does the machine-wide part, then (run from inside a project) wires that project's .env:

atelier-coolify configure
# or, inside a Claude Code session:
/coolify-integration:setup

Per-project auth

Each project carries its own credentials in its .env (kept gitignored by atelier's .env* guardrail):

COOLIFY_BASE_URL=https://coolify.example.com
COOLIFY_API_TOKEN=<token>

atelier-coolify reads these from the project's .env (or $COOLIFY_ENV_FILE, or the environment) at call time.

Usage

Run atelier-coolify --help, or let the coolify skill drive it. Common flow:

atelier-coolify list                         # find the app UUID
atelier-coolify deploy-mode <uuid>           # auto-deploy on push, or manual?
atelier-coolify validate <uuid>              # status + logs if unhealthy
atelier-coolify set-env <uuid> API_URL=https://api.example.com
atelier-coolify deploy <uuid>                # apply the change

deploy-mode reports whether the app auto-deploys on a push to its watched branch (GitHub App wiring) or needs a manual deploy. On an auto-deploy app a push to the watched branch is the deploy, so the coolify skill skips the redundant manual trigger for code changes (a set-env change still needs a deploy, since it does not go through git). The result is cached per project in .coolify-deploy-mode.json — add that file to the project's .gitignore; pass --refresh after changing the app's git settings in Coolify.

How permissions work

This plugin stays fully decoupled from atelier — it never edits atelier's shipped settings.template.json. Instead, /coolify-integration:setup (or atelier-coolify enable-permissions) merges the routine allowlist into your user-level settings.json ($ATELIER_CONFIG_DIR/settings.json), which persists across tasks and applies on top of atelier's per-task settings:

"Bash(atelier-coolify list:*)",
"Bash(atelier-coolify status:*)",
"Bash(atelier-coolify logs:*)",
"Bash(atelier-coolify deployments:*)",
"Bash(atelier-coolify validate:*)",
"Bash(atelier-coolify deploy-mode:*)",
"Bash(atelier-coolify deploy:*)",
"Bash(atelier-coolify set-env:*)",
"Bash(atelier-coolify health:*)",
"Bash(atelier-coolify version:*)",
"Skill(coolify-integration:*)"

The merge is idempotent and order-preserving, and touches nothing else in the file. The gated commands (create-app-public, delete-app) are deliberately omitted so they fall back to operator confirmation. Undo with atelier-coolify disable-permissions.

API compatibility

Targets Coolify v4's /api/v1 endpoints. If your instance differs, adjust the paths in scripts/atelier-coolify.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados