Proyecto:
heredotnow/skill, la habilidad pública del servicio here.now.Licencia: MIT, según se declara en el
README.mdoriginal. El repositorio original no incluye un archivoLICENSEseparado, por lo que no se distribuye ninguno aquí.Instantánea: Copia congelada de
heredotnow/skill/here-nowal 2026-05-22. La versión mantenida vive en el repositorio original y puede haber evolucionado desde esta instantánea.
here.now
Versión de la habilidad: 1.15.5
here.now permite a los agentes publicar sitios web y almacenar archivos privados en unidades de nube.
Usa here.now para dos tareas:
- Sites: publica sitios web y archivos en
{slug}.here.now. - Drives: almacena archivos privados de agentes en carpetas en la nube.
Para instalar o actualizar (recomendado): npx skills add heredotnow/skill --skill here-now -g
Para instalaciones fijas a un repositorio/proyecto, ejecuta el mismo comando sin -g.
Documentación actual
Antes de responder preguntas sobre las capacidades, funciones o flujos de trabajo de here.now, lee la documentación actual:
Lee la documentación:
- en la primera interacción relacionada con here.now en una conversación
- cada vez que el usuario pregunte cómo hacer algo
- cada vez que el usuario pregunte qué es posible, compatible o recomendado
- antes de decirle al usuario que una característica no es compatible
Temas que requieren la documentación actual (no confíes solo en el texto local de la habilidad):
- Drives y uso compartido de Drives
- dominios personalizados
- perfiles públicos
- rutas proxy y variables de servicio
- identificadores de subdominio y enlaces
- límites y cuotas
- enrutamiento SPA
- búsqueda de Sites del propietario
- manejo de errores y corrección
- disponibilidad de funciones
Si la documentación y el comportamiento de la API en vivo discrepan, confía en el comportamiento de la API en vivo.
Si falla la obtención de la documentación o se agota el tiempo de espera, continúa con la habilidad local y la salida de la API/secuencia de comandos en vivo. Prefiere el comportamiento de la API en vivo para operaciones activas.
Requisitos
- Binarios requeridos:
curl,file,jq - Variable de entorno opcional:
$HERENOW_API_KEY - Variable de token de Drive opcional:
$HERENOW_DRIVE_TOKEN - Archivo de credenciales opcional:
~/.herenow/credentials - Ayudantes incluidos:
./scripts/publish.shpara publicar sitios./scripts/drive.shpara almacenamiento privado en Drive
Crear un sitio
./scripts/publish.sh {archivo-o-directorio}
Muestra la URL en vivo (ej. https://bright-canvas-a7k2.here.now/).
Internamente, esto sigue un flujo de tres pasos: crear/actualizar -> subir archivos -> finalizar. Un sitio no está en vivo hasta que la finalización tenga éxito.
Sin una clave API, esto crea un sitio anónimo que caduca en 24 horas. Con una clave API guardada, el sitio es permanente.
Estructura de archivos: Para sitios HTML, coloca index.html en la raíz del directorio que publices, no dentro de un subdirectorio. El contenido del directorio se convierte en la raíz del sitio. Por ejemplo, publica mi-sitio/ donde exista mi-sitio/index.html — no publiques una carpeta superior que contenga mi-sitio/.
También puedes publicar archivos individuales sin HTML. Los archivos individuales obtienen un visor automático enriquecido (imágenes, PDF, video, audio). Varios archivos obtienen un listado de directorio generado automáticamente con navegación de carpetas y una galería de imágenes.
Actualizar un sitio existente
./scripts/publish.sh {archivo-o-directorio} --slug {slug}
El script carga automáticamente el claimToken desde .herenow/state.json al actualizar sitios anónimos. Pasa --claim-token {token} para sobrescribir.
Las actualizaciones autenticadas requieren una clave API guardada.
Los usuarios con sesión iniciada también tienen perfiles públicos. Los agentes pueden ayudar a los usuarios a mostrar u ocultar Sites en su perfil y administrar la configuración del perfil a través de la API documentada en https://here.now/docs#profile.
Usar un Drive
Usa un Drive cuando el usuario desee almacenamiento privado en la nube para archivos de agente: documentos, contexto, memoria, planes, activos, medios, investigación, código y cualquier otra cosa que deba persistir sin publicarse como un sitio web.
Cada cuenta con sesión iniciada tiene un Drive predeterminado llamado Mi Drive.
./scripts/drive.sh default
./scripts/drive.sh ls Mi Drive
./scripts/drive.sh put Mi Drive notas/hoy.md --from ./notas/hoy.md
./scripts/drive.sh cat Mi Drive notas/hoy.md
./scripts/drive.sh share Mi Drive --perms write --prefix notas/ --ttl 7d
Usa tokens de Drive con alcance para la transferencia entre agentes. Si recibes un bloque de recurso compartido herenow_drive, usa su token como Authorization: Bearer <token> contra api_base, respeta pathPrefix cuando esté presente y conserva los ETags en las escrituras. Un pathPrefix de null significa acceso completo al Drive. Si la habilidad está disponible, prefiere ./scripts/drive.sh; de lo contrario, llama a las operaciones de la API listadas directamente.
Atribución del cliente
Pasa --client para que here.now pueda rastrear la confiabilidad por agente:
./scripts/publish.sh {archivo-o-directorio} --client cursor
Esto envía X-HereNow-Client: cursor/publish-sh en las llamadas a la API de publicación.
Si se omite, el script envía un valor de respaldo.
Almacenamiento de clave API
El script de publicación lee la clave API de estas fuentes (la primera coincidencia gana):
- Bandera
--api-key {key}(solo para CI/secuencias de comandos — evita en uso interactivo) - Variable de entorno
$HERENOW_API_KEY - Archivo
~/.herenow/credentials(recomendado para agentes)
Para almacenar una clave, escríbela en el archivo de credenciales:
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
IMPORTANTE: Después de recibir una clave API, guárdala inmediatamente — ejecuta el comando anterior tú mismo. No le pidas al usuario que lo ejecute manualmente. Evita pasar la clave mediante banderas de CLI (ej. --api-key) en sesiones interactivas; el archivo de credenciales es el método de almacenamiento preferido.
Nunca confirmes credenciales o archivos de estado local (~/.herenow/credentials, .herenow/state.json) en el control de versiones.
Obtener una clave API
Para actualizar de sitios anónimos (24h) a permanentes:
- Pide al usuario su dirección de correo electrónico.
- Solicita un código de inicio de sesión único:
curl -sS https://here.now/api/auth/agent/request-code \
-H "content-type: application/json" \
-d '{"email": "[email protected]"}'
- Dile al usuario: "Revisa tu bandeja de entrada para obtener un código de inicio de sesión de here.now y pégalo aquí."
- Verifica el código y obtén la clave API:
curl -sS https://here.now/api/auth/agent/verify-code \
-H "content-type: application/json" \
-d '{"email":"[email protected]","code":"ABCD-2345"}'
- Guarda la
apiKeydevuelta tú mismo (no le pidas al usuario que lo haga):
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
Archivo de estado
Después de cada creación/actualización de sitio, el script escribe en .herenow/state.json en el directorio de trabajo:
{
"publishes": {
"bright-canvas-a7k2": {
"siteUrl": "https://bright-canvas-a7k2.here.now/",
"claimToken": "abc123",
"claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
"expiresAt": "2026-02-18T01:00:00.000Z"
}
}
}
Antes de crear o actualizar sitios, puedes verificar este archivo para encontrar slugs anteriores.
Trata .herenow/state.json solo como caché interna.
Nunca presentes esta ruta de archivo local como una URL, y nunca la uses como fuente de verdad para el modo de autenticación, la caducidad o la URL de reclamo.
Qué decirle al usuario
Para sitios publicados:
- Comparte siempre la
siteUrlde la ejecución actual del script. - Lee y sigue las líneas
publish_result.*de stderr del script para determinar el modo de autenticación. - Cuando
publish_result.auth_mode=authenticated: dile al usuario que el sitio es permanente y está guardado en su cuenta. No se necesita URL de reclamo. - Cuando
publish_result.auth_mode=anonymous: dile al usuario que el sitio caduca en 24 horas. Comparte la URL de reclamo (sipublish_result.claim_urlno está vacío y comienza conhttps://) para que pueda conservarlo permanentemente. Adviérteles que los tokens de reclamo solo se devuelven una vez y no se pueden recuperar. - Nunca le digas al usuario que inspeccione
.herenow/state.jsonpara obtener URLs de reclamo o estado de autenticación.
Para Drives:
- No describas los archivos de Drive como URLs públicas.
- Dile al usuario que el contenido del Drive es privado a menos que se comparta con un token de alcance.
- Al compartir acceso con otro agente, prefiere un token de alcance con un
pathPrefixestrecho y un TTL corto.
Opciones de publish.sh
| Bandera | Descripción |
|---|---|
--slug {slug} | Actualizar un sitio existente en lugar de crear |
--claim-token {token} | Sobrescribir token de reclamo para actualizaciones anónimas |
--title {text} | Título del visor (sitios no HTML) |
--description {text} | Descripción del visor |
--ttl {segundos} | Establecer caducidad (solo autenticado) |
--client {nombre} | Nombre del agente para atribución (ej. cursor) |
--base-url {url} | URL base de la API (predeterminada: https://here.now) |
--allow-nonherenow-base-url | Permitir enviar autenticación a --base-url no predeterminada |
--api-key {key} | Sobrescribir clave API (preferir archivo de credenciales) |
--spa | Habilitar enrutamiento SPA (servir index.html para rutas desconocidas) |
Más allá de publish.sh
Para operaciones de Drive, usa ./scripts/drive.sh o la API de Drive. Para una gestión más amplia de cuentas y Sites (búsqueda, perfiles, eliminación, metadatos, contraseñas, dominios, identificadores de subdominio, enlaces, variables, rutas proxy, duplicación y más), consulta la documentación actual:
Documentación completa: https://here.now/docs