Wakelog

Todo lo que puedes hacer en la web, puedes hacerlo con una sola solicitud HTTP. Tu token de API está en tu panel. Los cuerpos de las publicaciones pueden estar codificados como formulario (como abajo) o JSON (Content-Type: application/json).

La CLI de wakelog

Un script bash de ~120 líneas, cero dependencias más allá de curl. Léelo primero si quieres: https://wakelog.wakelog.workers.dev/wakelog

# install (puts one script in ~/.local/bin) curl -fsSL https://wakelog.wakelog.workers.dev/install.sh | sh # one-time setup: project slug + API token wakelog init my-app wl_YOUR_API_TOKEN # ship it wakelog post "v1.4: Dark mode" -t new -b "You asked, we shipped." git log -1 --pretty=%B | wakelog post "Deployed $(date +%F)" wakelog list # or draft the post straight from your git history: # commits since your last tag become the body; HEAD's tag becomes the title wakelog post --from-git wakelog post "Sprint 12" --from-git v1.3..HEAD -t improved # draft at tag time, flip it live when the deploy is green # (works with a scoped wlp_ CI token — no account token in CI) wakelog post "v2.0: The big one" --draft # prints the draft id wakelog publish 42

--from-git convierte los asuntos de git log (excluyendo merges) en una lista de viñetas de markdown — perfecto al final de un script de lanzamiento. Pasa una etiqueta/ref (commits desde ella) o un rango explícito de A..B; sin argumento usa tu última etiqueta. ¿Quieres secciones agrupadas de keep-a-changelog en lugar de una lista de viñetas? Pega el mismo git log en el generador de notas de lanzamiento — no se necesita registro.

Crear una publicación

curl -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts \ -H "Authorization: Bearer wl_YOUR_API_TOKEN" \ -d title="v1.4: Dark mode" \ -d tag=new \ -d body="You asked, we shipped. **Dark mode** is live."

tag es opcional: uno de new, improved, fix, announcement, security. body es markdown (negritas, cursivas, código, enlaces, imágenes — ![alt](https://…), solo https, enlazados desde donde los alojes — listas, encabezados, bloques de código delimitados). Devuelve 201 con la URL pública.

Borradores

Añade -d draft=true para guardar la publicación oculta — no aparecerá en la página pública, feeds, widget, insignia o exportaciones hasta que se publique. Escribe el anuncio en CI antes de que salga el lanzamiento, luego actívalo con una llamada (publicar sella la publicación con la fecha de publicación):

# write it ahead of time (CLI: wakelog post "v2.0" --draft) curl -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts -H "Authorization: Bearer wl_YOUR_API_TOKEN" -d title="v2.0: The big one" -d draft=true # ship day: publish draft POST_ID (CLI: wakelog publish POST_ID) curl -X PATCH https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts/POST\_ID -H "Authorization: Bearer wl_YOUR_API_TOKEN" -d draft=false

Publicación programada

O evita por completo el trabajo del día del lanzamiento: pasa publish_at (ISO 8601, se asume UTC si no hay offset) y Wakelog publica la publicación por ti dentro de ~5 minutos de esa hora — las notificaciones salientes de Discord/Slack/webhook también se disparan entonces. La publicación es un borrador oculto hasta que llega el momento. Funciona desde el formulario web ("programarlo"), la API y la CLI (wakelog post "v2.0" --at 2026-08-01T14:00Z). Cambia la hora o desprograma con PATCH publish_at=… / publish_at= (vacío lo limpia), o publica inmediatamente con draft=false.

# queue Friday's announcement on Tuesday curl -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts -H "Authorization: Bearer wl_YOUR_API_TOKEN" -d title="v2.0: The big one" -d publish_at=2026-08-07T15:00Z

Importar un CHANGELOG.md existente — o tus releases de GitHub

Trae toda tu historia en un solo comando. Se entienden el estilo keep-a-changelog (## [1.2.0] - 2024-05-01) y la mayoría de los formatos comunes; las fechas se conservan, y las entradas cuyo título ya existe se omiten — seguro de volver a ejecutar. Pasa una URL de repositorio GitHub, GitLab o Codeberg como url= y Wakelog importa las Releases publicadas del repositorio en su lugar (repos públicos, las 100 más recientes). Una URL de feed RSS o Atom también funciona — Headway, LaunchNotes, AnnounceKit y la mayoría de las otras herramientas de changelog alojadas exponen una (también lo hace github.com/you/repo/releases.atom); los títulos de los elementos, fechas y cuerpos HTML se convierten en entradas de markdown. Si das la URL de una página de changelog HTML, Wakelog busca su feed anunciado automáticamente.

# with the CLI (reads./CHANGELOG.md, shows a preview, asks to confirm) wakelog import # or raw API — send the file, or a url= to fetch it from; dry_run=1 to preview curl -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/import \ -H "Authorization: Bearer wl_YOUR_API_TOKEN" \ --data-urlencode changelog@CHANGELOG.md # import a public repo's GitHub Releases curl -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/import \ -H "Authorization: Bearer wl_YOUR_API_TOKEN" \ -d url=https://github.com/you/repo -d dry_run=1

Listar publicaciones (público, sin autenticación)

curl https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts

Parámetros opcionales: ?q=term (buscar título + cuerpo), ?format=text (listado en texto plano). Las páginas públicas admiten la misma búsqueda a través del cuadro de búsqueda o ?q=. Cada publicación incluye sus conteos de emoji reactions cuando tiene alguno.

Reacciones

Cada publicación pública tiene botones de reacción con emoji anónimos (👍 🎉 ❤️ 🚀) — comentarios sin cookies de tus lectores, contabilizados en tu panel. Simplemente funcionan; no hay nada que configurar. Programático: POST /p/YOUR-PROJECT/react/POST_ID con emoji=👍 (limitado por IP).

Editar una publicación

curl -X PATCH https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts/POST\_ID \ -H "Authorization: Bearer wl_YOUR_API_TOKEN" \ -d title="v1.4.1: Dark mode (fixed)"

Envía solo los campos que quieras cambiar (title, body, tag, draft — draft=false publica un borrador y lo fecha hoy). Los IDs de las publicaciones están en la respuesta de listar publicaciones.

Eliminar una publicación

curl -X DELETE https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts/POST\_ID \ -H "Authorization: Bearer wl_YOUR_API_TOKEN"

Publicación automática desde releases de GitHub / GitLab / Gitea

Habilita el webhook de releases en la página del panel de tu proyecto para obtener una URL de payload y un secreto, luego añade un webhook en la configuración de tu repositorio (GitHub/Gitea: tipo de contenido application/json, solo evento Releases; GitLab: Release events). Cada release publicado se convierte en una publicación — el nombre del release como título, las notas del release como cuerpo markdown, etiquetado release (o pre-release). Las firmas se verifican (X-Hub-Signature-256 / X-Gitea-Signature / X-Gitlab-Token), los borradores se omiten, y las reentregas con el mismo título se deduplican — seguro de reentregar.

GitHub / Gitea: https://wakelog.wakelog.workers.dev/hooks/github/YOUR-PROJECT GitLab: https://wakelog.wakelog.workers.dev/hooks/gitlab/YOUR-PROJECT

Anunciar nuevas publicaciones a Discord / Slack / cualquier webhook

Configura una URL de webhook en la tarjeta Anunciar nuevas publicaciones en la página del panel de tu proyecto y cada publicación publicada (web, API, CLI o webhook de release) envía un mensaje allí. Las URLs de webhook de Discord y las URLs de webhook entrante de Slack reciben un mensaje formateado con un enlace a la publicación; cualquier otro endpoint HTTPS recibe JSON: {event: "post_published", project, project_name, title, tag, url, published_at}. Los borradores notifican cuando se publican, no cuando se guardan. Usa "Enviar prueba" en el panel para verificar tu conexión.

Publicar automáticamente en cada despliegue

Añade una línea al final de tu script de despliegue o trabajo de CI:

curl -sf -X POST https://wakelog.wakelog.workers.dev/api/v1/YOUR-PROJECT/posts \ -H "Authorization: Bearer $WAKELOG_TOKEN" \ -d title="Deployed $(git log -1 --format=%s)" \ -d body="$(git log -1 --format=%b)"

Tokens de CI con alcance

No pongas tu token de cuenta en CI. Cada proyecto puede emitir un token de CI con alcance (wlp_…, generado en la página del panel del proyecto) que funciona solo en ese proyecto, y solo para POST /api/v1/<slug>/posts (borradores y publish_at incluidos), POST /api/v1/<slug>/import, y publicar un borrador existente — PATCH /api/v1/<slug>/posts/<id> con exactamente {"draft": false} y nada más — para que un pipeline pueda redactar en el momento de la etiqueta y activar la publicación cuando el despliegue esté en verde. Sin lecturas, sin ediciones de contenido, sin eliminaciones, sin otros proyectos. Úsalo como un valor Authorization: Bearer de reemplazo en los comandos anteriores (los comandos post / import / publish de la CLI también lo aceptan). Si se filtra, rota o revócalo en el panel; tu token de cuenta nunca se expone.

Revisar tu changelog en CI (sin autenticación)

El linter de changelog tiene una API JSON — sin token, no se guarda nada (30 ejecuciones/hora/IP). Envía el texto del archivo en changelog (o un url público — repositorio de GitHub/GitLab/Codeberg, CHANGELOG.md crudo, o cualquier feed de changelog); obtén {grade, score, checks, issues}. Añade format=text para un informe en texto plano. La CLI lo envuelve con un código de salida, para que tu pipeline pueda fallar cuando el changelog se desvía:

# CI gate: exits 1 if the grade drops below B wakelog lint CHANGELOG.md --min-grade B # or raw curl (JSON report) curl -sS -X POST https://wakelog.wakelog.workers.dev/api/v1/lint \ --data-urlencode changelog@CHANGELOG.md

Feeds e incrustaciones

Página pública: https://wakelog.wakelog.workers.dev/p/YOUR-PROJECT
Feed RSS: https://wakelog.wakelog.workers.dev/p/YOUR-PROJECT/rss.xml
JSON Feed 1.1: https://wakelog.wakelog.workers.dev/p/YOUR-PROJECT/feed.json
Exportación Markdown (changelog completo, estilo keepachangelog — reimportable en cualquier lugar, incluso de vuelta en Wakelog; tus datos nunca están bloqueados): https://wakelog.wakelog.workers.dev/p/YOUR-PROJECT/changelog.md
Porción de resumen de la exportación — todo lo enviado en un rango de fechas, listo para pegar en un boletín o resumen: ?since=2026-07-01&until=2026-07-31 (inclusivo, YYYY-MM-DD; añade &tag=fix para filtrar por etiqueta)
Widget incrustable: <iframe src="https://wakelog.wakelog.workers.dev/p/YOUR-PROJECT/embed" width="380" height="440"></iframe>
Opciones del widget: ?theme=dark (o auto para seguir el SO del visitante; claro por defecto) y ?limit=5 (1–25 publicaciones, 10 por defecto)

Popover "Qué hay de nuevo" (script de inserción)

Una etiqueta de script añade una campana flotante a tu aplicación que muestra una insignia de recuento de no leídos cuando publicas algo nuevo, y abre tu changelog en un popover al hacer clic. El estado "visto" de los visitantes vive en su propio localStorage — sin cookies, nada almacenado en el servidor.