PrivateNote CLI
Secretos sin huella en scripts, pipes y CI — cifrados localmente antes de que cualquier dato llegue a la red.
En esta página
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-onlyhttps://privatenote.ai/note/…#…
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
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
| Nombre | Descripción |
|---|---|
| --expire 15m|1h|24h|7d | Vida útil de la nota (por defecto: 24h) |
| --burn / --no-burn | Destruir tras la primera visualización (por defecto: burn) |
| --title <text> | Título opcional antepuesto al contenido |
| --json | Imprimir { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Salida exclusiva de URL; seguro para stdout en pipes dentro de scripts |
| --force-stdout | Permitir 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) |
| --insecure | Permitir orígenes API http:// — solo para desarrollo local, nunca en producción |
| PRIVATENOTE_API_BASE_URL | Base URL predeterminada de API |
| PRIVATENOTE_WEB_ORIGIN | Origen del enlace para compartir (por defecto el origen de API) |
| PRIVATENOTE_ALLOWED_HOSTS | Lista de permitidos de hostnames separada por comas |
Integraciones relacionadas
Extensión del editor
Crea notas desde VS Code, Cursor o Codex IDE sin cambiar de contexto. Usa la barra lateral, un comando de texto seleccionado o la acción de la barra de título.
Ver documentaciónservidor MCP
Ofrece a un cliente MCP una herramienta local que cree enlaces de PrivateNote cuando un agente necesita entregar un secreto.
Ver documentaciónComplemento de códice
Instala el complemento incluido para MCP y skills, o añade privatenote-mcp a ~/.codex/config.toml. Usa la misma extensión de VS Code en Codex IDE para secretos que el agente nunca debe ver.
Ver documentaciónExtensión Chrome
Cifre texto seleccionado en cualquier pestaña con menú contextual, barra o atajo — sin abrir el sitio.
Ver documentaciónPrivateNote CLI
Secretos sin huella en scripts, pipes y CI — cifrados localmente antes de que cualquier dato llegue a la red.
