Coolify

Coolify Skill

Use this skill whenever the user asks to deploy/manage apps on Coolify.

Primary path: call the coolify_deploy tool (runtime-integrated, key-safe). Fallback path: raw API calls with curl only when debugging.

Environment Assumptions

• Coolify URL: https://coolify.semfreak.dev
• API key variable: COOLIFY_API_KEY
• Server IP: 66.90.191.45
• Wildcard domain: *.semfreak.dev
• GitHub org: webdevtodayjason

The key is stored encrypted in service keys and resolved by runtime at call-time. Do not ask users to paste plaintext keys into chat.

Tool Action Map

• test_connection:
• Checks GET /api/v1/version.
• list_servers:
• Lists server UUIDs/IDs available in Coolify.
• list_projects:
• Lists projects and identifiers.
• create_project:
• Creates a Coolify project.
• create_database:
• Creates PostgreSQL resource in a project.
• create_application:
• Creates app resource from GitHub repo + branch + domain.
• trigger_deploy:
• Triggers deployment for application UUID.
• deployment_status:
• Reads deployment state by deployment UUID or by app UUID.
• deployment_logs:
• Reads logs for a deployment UUID (or latest deployment for an app UUID).
• deploy_project:
• Full pipeline:
• optional GitHub repo create (gh)
• optional local scaffold + commit + push
• Coolify project/db/app provisioning
• optional deploy trigger
• teardown_project:
• Deletes app/database resources for a project, then deletes the project.

Canonical Flow

When user asks: "build and deploy "

1. Validate access:

• coolify_deploy with action: test_connection

1. Resolve server:

• action: list_servers (or use COOLIFY_DEFAULT_SERVER_ID if already set)

1. Run full deploy:

• action: deploy_project

1. Return evidence:

• Project UUID
• App UUID
• Deployment UUID/status
• Live URL (https://.semfreak.dev)

Minimal Full Deploy Input

{
  "action": "deploy_project",
  "project_name": "invoicer",
  "project_description": "Node.js API with Postgres",
  "repo_org": "webdevtodayjason",
  "repo_name": "invoicer",
  "stack": "node",
  "domain": "invoicer.semfreak.dev",
  "deploy_now": true
}

Granular Mode Examples

Create project:

{
  "action": "create_project",
  "project_name": "invoicer",
  "project_description": "Node API"
}

Create database:

{
  "action": "create_database",
  "project_uuid": "",
  "project_name": "invoicer",
  "server_uuid": "",
  "environment_name": "production"
}

Create application:

{
  "action": "create_application",
  "project_uuid": "",
  "project_name": "invoicer",
  "server_uuid": "",
  "repo_org": "webdevtodayjason",
  "repo_name": "invoicer",
  "branch": "main",
  "domain": "invoicer.semfreak.dev",
  "app_port": 3000
}

Trigger deploy:

{
  "action": "trigger_deploy",
  "application_uuid": ""
}

Status check:

{
  "action": "deployment_status",
  "application_uuid": "",
  "limit": 1
}

Operator Notes

• Prefer deploy_project unless troubleshooting.
• Keep project/repo/domain naming aligned (`, -app, -db, .semfreak.dev`).
• If gh auth is missing, stop and return exact remediation.
• If Coolify responds with schema/endpoint mismatch, capture status + response body and report for adapter update.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ArgentAIOS
• Source: ArgentAIOS/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.