steipete/clickclack

Operaciones de ClickClack: app de chat, despliegue en Hetzner, DNS/docs/app, rollout con Docker.

¿Qué es clickclack?

ClickClack es una skill diseñada para gestionar las operaciones y despliegues del producto ClickClack, un chat estilo Slack auto-alojable orientado a flujos de trabajo comunitarios y de agentes. Soporta plataformas como Claude Code, Cursor y Codex, y se enfoca en mantener la aplicación y sus superficies web: el sitio del producto (clickclack.chat), la aplicación alojada (app.clickclack.chat) y la documentación (docs.clickclack.chat). La skill proporciona un camino dorado para el despliegue que incluye la actualización local del repositorio, la evaluación de cambios mediante git log y diff, el archivado limpio con git archive, la preservación segura de variables de entorno sin exponer secretos, la creación de backups de la base de datos SQLite antes de migraciones, la construcción de una nueva imagen Docker, el reemplazo del contenedor en ejecución y la rotación de directorios de código fuente. También incluye comandos de verificación tanto en el host como en los endpoints públicos, y guardarraíles críticos como no imprimir tokens OAuth, usar archivos de known hosts temporales si es necesario, y siempre respaldar la base de datos antes de reemplazar el contenedor.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/clickclack

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace clickclack?

Utiliza esto para operaciones de producto/tiempo de ejecución de ClickClack, despliegues, comprobaciones de la aplicación alojada y preguntas sobre dominios.

Qué

  • Repo: ~/Projects/clickclack / https://github.com/openclaw/clickclack
  • Producto: chat estilo Slack auto-alojable para flujos de trabajo de OpenClaw/comunidad/agentes.
  • Superficies:
    • https://clickclack.chat sitio del producto
    • https://app.clickclack.chat aplicación alojada
    • https://docs.clickclack.chat documentación en GitHub Pages desde docs/

Producción

  • Hetzner: clickclack-prod-01
  • IPv4: 157.90.237.80
  • IPv6: 2a01:4f8:1c1c:fb96::/64
  • SSH: [email protected]
  • Etiquetas: app=clickclack, env=prod
  • SO: Ubuntu 24.04, Caddy + Docker
  • Código fuente en el host: /opt/clickclack-src (exportación limpia, no un checkout de git)
  • Código fuente anterior: /opt/clickclack-src.prev más directorios antiguos con marca de tiempo
  • Datos: /var/lib/clickclack montado como bind en /app/data
  • Contenedor: clickclack, puerto 127.0.0.1:8080->8080
  • Caddy: /etc/caddy/Caddyfile hace proxy de clickclack.chat, app.clickclack.chat a 127.0.0.1:8080; www redirige al apex.
  • Verdad DNS: ~/Projects/manager/DOMAINS.md y ~/Projects/manager/DNS.md

Despliegue

Camino dorado:

  1. Actualización local:
    • cd ~/Projects/clickclack
    • git status --short --branch
    • git fetch origin
    • Si estás en main sin upstream: git merge --ff-only origin/main
  2. Decidir el delta desplegado:
    • El último despliegue conocido puede ser el antiguo HEAD local antes del pull; verificar /opt/clickclack-src/.deploy-commit si existe.
    • git log --oneline <old>..HEAD
    • git diff --stat <old>..HEAD
  3. Archivar solo HEAD limpio:
    • No rsync archivos locales no rastreados.
    • short=$(git rev-parse --short=12 HEAD)
    • git archive --format=tar HEAD | ssh [email protected] "rm -rf /opt/clickclack-src.next && mkdir -p /opt/clickclack-src.next && tar -C /opt/clickclack-src.next -xf - && printf '%s\n' '$short' > /opt/clickclack-src.next/.deploy-commit"
  4. Preservar env sin imprimir secretos:
    • docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
  5. Backup antes de migraciones:
    • mkdir -p /var/lib/clickclack/backups
    • chown 1000:1000 /var/lib/clickclack/backups
    • docker exec clickclack clickclack backup --data /app/data --out /app/data/backups/clickclack-before-$(date -u +%Y%m%dT%H%M%SZ).db
  6. Construir:
    • docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
  7. Reemplazar contenedor:
    • docker stop clickclack && docker rm clickclack
    • docker run -d --name clickclack --restart unless-stopped --env-file /root/clickclack.env.current -p 127.0.0.1:8080:8080 -v /var/lib/clickclack:/app/data clickclack:latest serve --addr :8080 --data /app/data
  8. Rotar directorios de código fuente:
    • Mover el antiguo /opt/clickclack-src.prev a un backup con marca de tiempo.
    • Mover /opt/clickclack-src a /opt/clickclack-src.prev.
    • Mover /opt/clickclack-src.next a /opt/clickclack-src.

Verificar

  • Host:
    • docker ps --filter name=clickclack
    • docker inspect clickclack --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
    • cat /opt/clickclack-src/.deploy-commit
    • curl -fsS http://127.0.0.1:8080/ >/tmp/clickclack-root.html
    • curl -fsS http://127.0.0.1:8080/app >/tmp/clickclack-app.html
  • Público:
    • curl -I https://clickclack.chat
    • curl -I https://app.clickclack.chat
    • curl -I https://docs.clickclack.chat

Guardarraíles

  • No imprimir secretos OAuth ni tokens mágicos.
  • Usar un UserKnownHostsFile desechable si el estado de la clave de host SSH local está desactualizado; confirmar la identidad del servidor con hcloud server describe clickclack-prod-01 primero.
  • clickclack serve ejecuta migraciones al iniciar; siempre hacer backup de SQLite antes de reemplazar el contenedor.
  • Mantener los despliegues desde archivos git limpios, no desde árboles de trabajo sucios.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills relacionados