urieljareth/Proxmox-Coolify-Manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Actualiza toolkit operativo y documentación

Browse Source
This commit is contained in:
urieljareth
2026-09-10 20:53:50 -06:00
parent 3b7209dcc1
commit 714057bfc8
69 changed files with 6023 additions and 384 deletions
Download Patch File Download Diff File Expand all files Collapse all files
coolify_skill/SKILL.md
+20 -8
View File
@@ -1,6 +1,6 @@
---
name: coolify-agent
description: Operate the local self-hosted Coolify stack for this Proxmox and Coolify Manager project. Use when Codex needs to inspect Coolify, Docker containers inside LXC 102, applications, services, databases, deployments, logs, environment variables, or Coolify API resources on the local infrastructure.
description: Operate the local self-hosted Coolify stack for this Proxmox and Coolify Manager project. Use when the agent needs to inspect Coolify, Docker containers inside LXC 102, applications, services, databases, deployments, logs, environment variables, or Coolify API resources on the local infrastructure.
---
# Coolify Agent
@@ -11,14 +11,18 @@ changing production state.
## Startup Routine
1. Read `README.md`, `docs/proxmox-inventory.md`, and
`docs/runbooks/coolify-docker.md`.
2. For app-specific work, also read the matching runbook, for example
1. Load secrets: `. .\.env.local.ps1`.
2. Read [`docs/TOOL-INDEX.md`](../docs/TOOL-INDEX.md) — the canonical tool
catalog. **Its §1 lists four gotchas that produce silently wrong results**;
two of them (`-Raw` inversion, `/applications` 404) bite on every Coolify task.
3. Read [`docs/proxmox-inventory.md`](../docs/proxmox-inventory.md) for current
state, and `docs/runbooks/coolify-docker.md` for the procedure.
4. For app-specific work, also read the matching runbook, for example
`docs/runbooks/nextcloud.md`.
3. Run `.\scripts\Test-ProxmoxConnection.ps1` before operational work.
4. Discover current state before acting:
5. Run `.\scripts\Test-ProxmoxConnection.ps1` before operational work.
6. Discover current state before acting:
`.\coolify_skill\scripts\Get-CoolifyDockerStatus.ps1 -All`.
5. Use the Coolify API only when `COOLIFY_TOKEN` is loaded in the shell.
7. Use the Coolify API only when `COOLIFY_TOKEN` is loaded in the shell.
## Local Context
@@ -27,7 +31,15 @@ changing production state.
- Docker is not managed directly on Proxmox; use
`pct exec 102 -- docker ...` through `.\scripts\Invoke-ProxmoxSsh.ps1`.
- Default Coolify API base URL:
`https://coolify.urieljareth.org/api/v1`.
`https://coolify.urieljareth.org/api/v1`. Coolify runs **v4.3.14** (verified
2026-08-29) and its REST API is **complete against the origin**
(`http://192.168.0.117:8000/api/v1`, `$env:COOLIFY_API_URL_ORIGIN`): the
`/applications/*` and `/github-apps` 404s only happen through the public
Cloudflare hostname — an edge block, not a Coolify limitation. Call those
endpoints against the origin. State-changing endpoints are POST-only since
v4.2. Otherwise enumerate apps via `/resources`.
- **Container names are `<service>-<uuid>`** and change when a redeploy recreates
the container. Never hardcode one — resolve it first.
- Secrets must live in local environment files or the OS secret store, never in
Markdown or skill references.