agentmods.dev

coolify AGENTS.md

A set of repository instructions for Coolify, an open-source tool that manages applications, servers, databases, and other services. It explains the project structure, design guidance, and Docker-based development setup.

In plain words
What is it for?
Use it when developing, styling, testing, or running Coolify locally, including work involving Laravel, Livewire, Tailwind CSS, Docker, or its design reference.
Why use it?
It gives coding agents the project context and local commands they need before changing code. This helps keep changes consistent with the repository's architecture and design rules.

Instructions file for CodexOpenCode

61k yesterday B scan 6,274 tokens original Apache-2.0
View the source file coollabsio/coolify
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/coollabsio/coolify/agents-md
Clone the repo
git clone --depth 1 https://github.com/coollabsio/coolify

Made for: Codex, OpenCode.

Per session 6,274 This file is loaded in full into every session.
When invoked 6,274 The same file — it is already loaded in full.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.06274 $0.06274
Opus 5 $0.03137 $0.03137
Sonnet 5 $0.01255 $0.01255
Haiku 4.5 $0.00627 $0.00627

Measured yesterday against content hash 5b83b669cc0a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

coolify AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- When adding remote shell commands, account for servers using non-root SSH users: commands pass through `parseCommandsByLineForSudo()`, so test pipelines, redirects, substitutions, and `sh -c`/`bash -c` scripts with the
AGENTS.md · 432 lines

How it starts

The opening of the file, as written. The whole thing — 432 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

This file provides guidance to agentic coding tools when working with code in this repository.

Project Overview

Coolify is an open-source, self-hostable PaaS (alternative to Heroku/Netlify/Vercel). It manages servers, applications, databases, and services via SSH. Built with Laravel 12 (using Laravel 10 file structure), Livewire 3, and Tailwind CSS v4.

Design Reference

For UI/UX design specifications, principles, and visual standards, consult the local DESIGN.md. It is the source of truth for frontend design work in this repository.

Development Environment

Docker Compose-based dev setup with services: coolify (app), postgres, redis, soketi (WebSockets), vite, testing-host, mailpit, minio.

# Start dev environment (uses docker-compose.dev.yml)
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
docker compose -f docker-compose.yml -f docker-compose.dev.yml down                        # stop services

# Two local Coolify instances (isolated stacks; server transfer / multi-control-plane)
./scripts/dev-instances up                   # a:8000 + b:8001 (uses npm run build for CSS/JS)
./scripts/dev-instances up a --with vite     # HMR only when starting a single instance
./scripts/dev-instances urls
./scripts/dev-instances down
# Compose: docker-compose.dev-multi.yml  Env: .dev-instances/{a,b}.env (gitignored)
# Note: dual Vite HMR is unsupported (shared public/hot); multi-instance always uses public/build.

The app runs at localhost:8000 by default. Instance b is on 8001 (db 5433, redis 6380, …); see ./scripts/dev-instances.

Testing the Self-Hosted Upgrade Process

Use the following workflow to test a self-hosted upgrade:

  1. Install the source version with the upgrade script:

    bash upgrade.sh sha-6492d081362c009519481ac70e50873e39ba1861

  2. Set the current Coolify version and rebuild the cached configuration:

    docker exec -e COOLIFY_VERSION=4.3.0 coolify php artisan config:cache

Read the full file on GitHub · 432 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 432 lines · 6,274 tokens per session scan B 5b83b669cc0a

Subscribe to this mod's changes

coolify AGENTS.md is an instructions file published in the GitHub repository coollabsio/coolify (61,212 stars, last pushed yesterday), licensed Apache-2.0. It adds 6,274 tokens to every session, about $0.0314 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

DatabasesFrontendTestingdockermysqlnodejsphpredisself-hosting
Related

Other instructions, from other repositories

FlyEnv AGENTS.md

Instructions for xpf0000/FlyEnv, covering flyenv - ai agent development guide, project overview, technology stack, core technologies and additional libraries.

xpf0000/FlyEnv · 3,063 tokens

Chat2DB AGENTS.md

AGENTS.md instructions for OtterMind/Chat2DB, covering chat2db community agent contract, context, product invariants, repository map and structural code navigation.

OtterMind/Chat2DB · 4,057 tokens

toBeBetterJavaer AGENTS.md

AGENTS.md instructions for itwanger/toBeBetterJavaer, covering 工具权限设置, 工具使用规则, 获取网页内容 and 图片生成 / 文章配图.

itwanger/toBeBetterJavaer · 306 tokens

toBeBetterJavaer CLAUDE.md

Claude Code instructions for itwanger/toBeBetterJavaer, covering claude.md, 你的形象, 项目概况, 目录地图 and 写作工作流.

itwanger/toBeBetterJavaer · 388 tokens

leoric AGENTS.md

Instructions for cyjake/leoric, covering agent guidelines, project overview, commands, architecture and conventions.

cyjake/leoric · 1,259 tokens

hal-9000 AGENTS.md

Instructions for vinta/hal-9000, covering agents.md, commands, gotchas, external tool documentation and context7 library ids.

vinta/hal-9000 · 786 tokens