Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection.

MITAuto-check passed

Install Coolify Setup

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill coolify-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins coolify-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/Sevi-py/coolify-codex-plugin/skills/coolify-setup .claude/skills/coolify-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
coolify-setup
GitHub stars
1.2k
Token cost
~999 tokens
SKILL.md length
489 words
Files
1
Skills in repo
686
Repo updated
First seen
Licence
MIT

At a glance

Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection.

  • Works in 5 steps: Run coolify_config_status to see whether… → If no usable connection exists, run… → Tell the user to complete the browser… → …
  • The user asks to set up Coolify from the Codex marketplace
  • SKILL.md covers Marketplace Flow, Self-Hosted Instances, Storage and Token Handling, plus 2 more sections
  • Calls npm; needs COOLIFY_API_TOKEN

What it does

Coolify Setup is an agent skill from hashgraph-online/awesome-codex-plugins. Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection. Use when the user asks to set up Coolify from the Codex marketplace, connect Coolify, configure saved credentials, log in, log out, switch Coolify instances, avoid environment variables, or resolve missing/invalid Coolify API token errors.

Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Model Context Protocol. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • The user asks to set up Coolify from the Codex marketplace
  • Connect Coolify
  • Configure saved credentials
  • Switch Coolify instances

Example prompts

  • “/coolify-setup”

Requirements

  • A credential in COOLIFY_API_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Run coolify_config_status to see whether a connection is already saved.
  2. If no usable connection exists, run coolify_configure without an apiToken argument.
  3. Tell the user to complete the browser window that opens. The page first asks whether Coolify is Cloud-hosted or self-hosted; for…
  4. Run coolify_config_status again after the user says they finished.
  5. If configured, continue with the requested Coolify task or switch to the coolify skill for operational work.

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • COOLIFY_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Coolify Setup loads about 999 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 489 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~999

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its MIT licence (© hashgraph-online). 489 words, ~999 tokens.

Download SKILL.mdSave it as .claude/skills/coolify-setup/SKILL.md (or your agent's skills folder).
name
coolify-setup
description
Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection. Use when the user asks to set up Coolify from the Codex marketplace, connect Coolify, configure saved credentials, log in, log out, switch Coolify instances, avoid environment variables, or resolve missing/invalid Coolify API token errors.
license
MIT

Coolify Setup

Use this skill for first-time setup, marketplace onboarding, saved credentials, login/logout, and connection troubleshooting for the Coolify plugin.

Marketplace Flow

Marketplace users should not need a repo checkout or shell command.

Before giving up on missing tools, call tool_search for coolify_config_status coolify_configure mcp__coolify when tool_search is available. The expected MCP namespace is mcp__coolify, and the setup tools are named coolify_config_status, coolify_configure, and coolify_logout.

  1. Run coolify_config_status to see whether a connection is already saved.
  2. If no usable connection exists, run coolify_configure without an apiToken argument.
  3. Tell the user to complete the browser window that opens. The page first asks whether Coolify is Cloud-hosted or self-hosted; for self-hosted instances it asks for the URL before showing the matching token page.
  4. Run coolify_config_status again after the user says they finished.
  5. If configured, continue with the requested Coolify task or switch to the coolify skill for operational work.

coolify_configure returns a short-lived local setup URL. If the browser does not open automatically, provide that URL to the user.

If the Coolify MCP tools are not exposed in the thread after tool search, do not work around it by importing files from the current workspace or running repo-local setup code unless the user explicitly says they are developing this plugin from that checkout. For normal marketplace use, explain that the plugin's MCP tools did not load, ask the user to reinstall or update the plugin, and have them start a brand-new top-level thread so Codex can pick up the MCP server. Do not present a same-thread retry, delegated follow-up, or fork of the failed thread as the fix; those can preserve stale plugin capability metadata.

Show full SKILL.md (212 more words)Show less

Self-Hosted Instances

The browser setup handles self-hosted instances without requiring the user to paste a URL into chat.

If the user already gave the instance URL, call coolify_configure with baseUrl set to the instance root or /api/v1 URL:

json
{
  "baseUrl": "https://coolify.example.com"
}

The setup page links to the matching /security/api-tokens page after the instance URL is known.

Storage

The token is stored locally:

  • macOS Keychain when available.
  • Windows Credential Manager when available.
  • Linux Secret Service via secret-tool when available.
  • Otherwise, a local config file under CODEX_HOME or ~/.codex with owner-only permissions.

Environment variables are fallback-only for automation:

  • COOLIFY_BASE_URL
  • COOLIFY_API_TOKEN

Do not make marketplace users set these manually.

Token Handling

  • Coolify API authentication uses Authorization: Bearer <token>.
  • Coolify does not currently document browser OAuth-style authorization for API clients.
  • Ask users to create a least-privileged scoped token.
  • Do not ask users to paste tokens into chat.
  • Never print, summarize, or echo API tokens.

Reset Or Switch Instance

  • Use coolify_logout to forget the saved local connection.
  • Then run coolify_configure again. The browser setup will ask whether the next connection is Coolify Cloud or self-hosted.

Local Development Fallback

Use this only when the user is developing the plugin from a local checkout and specifically wants a terminal command. Marketplace users should use coolify_configure instead.

They can run:

bash
npm run setup -- --save

For self-hosted instances:

bash
npm run setup -- --save https://coolify.example.com

© hashgraph-online, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/Sevi-py/coolify-codex-plugin/skills/coolify-setup of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Coolify Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Coolify Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Coolify Setup this skillhashgraph-online/awesome-codex-plugins1.2k—~999Automated safety check: PassMIT
Warp GUI to Agent CLI Migrationwarpdotdev/warp65k1 repos~2.1kAutomated safety check: PassAGPL-3.0
Security Reviewktnyt/cclsp675—~565Automated safety check: PassMIT
Project Healthjezweb/claude-skills1.1k1 repos~3kAutomated safety check: PassMIT
OneCLI Gatewaynanocoai/nanoclaw31k1 repos~856Automated safety check: PassMIT
Keypaste Designnotinferred/keypaste161—~865Automated safety check: PassAGPL-3.0

Similar skills

  • Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Security Review

    ktnyt/cclsp

    Request a security expert assessment for code changes that touch child process spawning, file system access, configuration loading, or environment variable handling.

    675 GitHub stars~565 tokensUpdated 7 mo ago
    SecurityAuto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Agent WorkflowsAuto-check passed
  • OneCLI Gateway

    nanocoai/nanoclaw

    Explains how to call external APIs through the OneCLI proxy, which injects stored credentials into outgoing HTTPS requests so the agent never handles keys.

    31k GitHub starsUsed in 1 repo~856 tokens
    Backend & APIsAuto-check passed
  • Keypaste Design

    notinferred/keypaste

    Keep keypaste's desktop screens, CLI output, site, README and brand assets on brand.

    161 GitHub stars~865 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Mongodb MCP Setup

    mongodb/agent-skills

    Official

    Guide users through configuring key MongoDB MCP server options.

    190 GitHub starsUsed in 1 repo~3.3k tokens
    DatabasesAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Coolify Setup

What does Coolify Setup do?

Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection. Coolify Setup is an agent skill from hashgraph-online/awesome-codex-plugins. Connect, authenticate, configure, reset, or troubleshoot the Coolify Codex plugin connection.

When should I use Coolify Setup?

Coolify Setup fits situations like: the user asks to set up Coolify from the Codex marketplace; connect Coolify; configure saved credentials; switch Coolify instances.

How do I install Coolify Setup in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill coolify-setup -a claude-code`. Or copy the skill folder (plugins/Sevi-py/coolify-codex-plugin/skills/coolify-setup in hashgraph-online/awesome-codex-plugins) into .claude/skills/coolify-setup in your project. Claude Code loads it when a task matches its description.

How do I install Coolify Setup in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill coolify-setup -a codex`. Or copy the skill folder (plugins/Sevi-py/coolify-codex-plugin/skills/coolify-setup in hashgraph-online/awesome-codex-plugins) into .agents/skills/coolify-setup in your project. Codex loads it when a task matches its description.

Can I use Coolify Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill coolify-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/coolify-setup, .gemini/skills/coolify-setup, .github/skills/coolify-setup and .opencode/skills/coolify-setup in your project.

What does Coolify Setup need to run?

Going by SKILL.md and its folder, Coolify Setup needs the command-line tools its instructions call (npm) and credentials named COOLIFY_API_TOKEN. Our summary lists: A credential in COOLIFY_API_TOKEN.

Does Coolify Setup access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Coolify Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Coolify Setup use?

Coolify Setup is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Coolify Setup use?

About 999 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Coolify Setup?

Skills that share tags, products or a category with Coolify Setup: Warp GUI to Agent CLI Migration (warpdotdev/warp, 65k stars), Security Review (ktnyt/cclsp, 675 stars), Project Health (jezweb/claude-skills, 1.1k stars) and OneCLI Gateway (nanocoai/nanoclaw, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Coolify Setup?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.