PrivateNote CLI

Secretos sin huella en scripts, pipes y CI — cifrados localmente antes de que cualquier dato llegue a la red.

Para quién es esto

Usa CLI cuando el secreto ya resida en un archivo, gestor de contraseñas o salida de un pipeline y necesites un enlace compartible sin tener que pegarlo en un chat o correo.

La herramienta lee desde stdin o una ruta de archivo, cifra con AES-256-GCM en tu máquina, sube solo el texto cifrado y muestra un URL con la clave de descifrado en el fragmento.

Las notas creadas de esta forma se registran como creationSource: cli en las analíticas.

Instalación

Requiere Node.js 18+. Funciona en macOS, Linux y Windows.

# Run once without installing
npx privatenote-cli --expire 1h --output-url-only

# Or install globally (adds the `privatenote` command)
npm install -g privatenote-cli

# Pipe a secret in scripts
cat secret.txt | privatenote --expire 1h --output-url-only

# Local self-host / wrangler dev (HTTP API — dev only)
echo "secret" | privatenote --insecure --api-base-url http://localhost:8787 --output-url-only

Probar en vivo

El mismo flujo que la CLI en el navegador: cifrar localmente, subir ciphertext, imprimir una URL con la clave en el fragmento.

Demo en vivo — crea una nota real en privatenote.ai. Use un secreto desechable, no credenciales de producción.

echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/…#…
# secreto
--expire

Arquitectura de seguridad

El texto plano nunca sale de tu máquina sin cifrar. El enlace de URL lleva la clave de descifrado en su #fragment, el cual los navegadores y clientes HTTP no envían a los servidores.

Cuando stdout no es un TTY (está en un pipe o capturado), CLI se niega a imprimir un enlace a menos que pases --output-url-only o --force-stdout — esto evita filtraciones accidentales en los logs de CI.

Cifrar localmente

AES-256-GCM en su dispositivo — navegador, editor, terminal o proceso MCP.

Subir ciphertext

Solo los bytes cifrados y los metadatos (caducidad, burn-after-reading) llegan al servidor.

Clave en #fragment

La clave de descifrado permanece en el hash de la URL. Los navegadores no envían fragmentos en solicitudes HTTP.

privatenote.ai/note/…#key

Diagrama completo en el hub de desarrolladores
  • HTTPS requerido para orígenes API remotos; usa --insecure solo para desarrollo local http:// (ej. wrangler dev en :8787).

  • PRIVATENOTE_ALLOWED_HOSTS fija los hostnames de API al usar una URL base API personalizada.

  • Validación de la forma de la respuesta y comprobaciones de ID de nota reservado antes de la subida.

  • Se prefiere redirigir la salida a un archivo con chmod 600 en lugar de mostrar las URLs.

Flags y variables de entorno

NombreDescripción
--expire 15m|1h|24h|7dVida útil de la nota (por defecto: 24h)
--burn / --no-burnDestruir tras la primera visualización (por defecto: burn)
--title <text>Título opcional antepuesto al contenido
--jsonImprimir { secureUrl, expiresAt, burnAfterReading }
--output-url-onlySalida exclusiva de URL; seguro para stdout en pipes dentro de scripts
--force-stdoutPermitir salida cuando stdout no es una terminal (usar con --json en CI)
--api-base-url <url>Sobrescribir el origen de API (HTTPS; usar con --insecure para http:// local)
--insecurePermitir orígenes API http:// — solo para desarrollo local, nunca en producción
PRIVATENOTE_API_BASE_URLBase URL predeterminada de API
PRIVATENOTE_WEB_ORIGINOrigen del enlace para compartir (por defecto el origen de API)
PRIVATENOTE_ALLOWED_HOSTSLista de permitidos de hostnames separada por comas

Integraciones relacionadas

PrivateNote CLI

Secretos sin huella en scripts, pipes y CI — cifrados localmente antes de que cualquier dato llegue a la red.

Foto: Léna Le Roy · Unsplash.