Files

Jason Woltje 80c3680ccb feat: rename rails/ to tools/ and add service tool suites

Rename the `rails/` directory to `tools/` for agent discoverability —
agents frequently failed to locate helper scripts due to the non-intuitive
directory name. Add backward-compat symlink `rails/ → tools/`.

New tool suites:
- Authentik: auth-token, user-list, user-create, group-list, app-list,
  flow-list, admin-status (8 scripts)
- Coolify: team-list, project-list, service-list, service-status, deploy,
  env-set (7 scripts)
- Woodpecker: pipeline-list, pipeline-status, pipeline-trigger (3 stubs)
- GLPI: session-init, computer-list, ticket-list, ticket-create, user-list
  (6 scripts)
- Health: stack-health.sh — stack-wide connectivity check

Infrastructure:
- Shared credential loader at tools/_lib/credentials.sh
- install.sh creates symlink + chmod on tool scripts
- All ~253 rails/ path references updated across 68+ files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-22 11:51:39 -06:00

deploy.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

env-set.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

project-list.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

README.md

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

service-list.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

service-status.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

team-list.sh

feat: rename rails/ to tools/ and add service tool suites

2026-02-22 11:51:39 -06:00

README.md

Coolify Tool Suite

Manage Coolify container deployment platform (projects, services, deployments, environment variables).

Prerequisites

jq and curl installed
Coolify credentials in ~/src/jarvis-brain/credentials.json (or $MOSAIC_CREDENTIALS_FILE)
Required fields: coolify.url, coolify.app_token

Scripts

Script	Purpose
`team-list.sh`	List teams
`project-list.sh`	List projects
`service-list.sh`	List all services
`service-status.sh`	Get service details and status
`deploy.sh`	Trigger service deployment
`env-set.sh`	Set environment variable on a service

Common Options

-f json — JSON output (default: table)
-u uuid — Service UUID (for service-specific operations)
-h — Show help

API Reference

Base URL: http://10.1.1.44:8000
API prefix: /api/v1/
Auth: Bearer token in Authorization header
Rate limit: 200 requests per interval

Known Limitations

FQDN updates on compose sub-apps not supported via API. Workaround: update directly in Coolify's PostgreSQL DB (coolify-db container, service_applications table).
Compose must be base64-encoded in docker_compose_raw field when creating services via API.
Don't send type with docker_compose_raw — API rejects payloads with both fields.

Coolify Magic Variables

Coolify reads special env vars from compose files:

SERVICE_FQDN_{NAME}_{PORT} — assigns a domain to a compose service
SERVICE_URL_{NAME}_{PORT} — internal URL reference
Must use list-style env syntax (- SERVICE_FQDN_API_3001), NOT dict-style.

Examples

# List all projects
~/.config/mosaic/tools/coolify/project-list.sh

# List services as JSON
~/.config/mosaic/tools/coolify/service-list.sh -f json

# Check service status
~/.config/mosaic/tools/coolify/service-status.sh -u <uuid>

# Set an env var
~/.config/mosaic/tools/coolify/env-set.sh -u <uuid> -k DATABASE_URL -v "postgres://..."

# Deploy a service
~/.config/mosaic/tools/coolify/deploy.sh -u <uuid>