PrivateNote CLI

Segredos com zero pegada em scripts, pipes e CI — criptografados localmente antes de qualquer coisa chegar à rede.

Para quem é isso

Use o CLI quando o segredo já estiver em um arquivo, gerenciador de senhas ou saída de pipeline e você precisar de um link compartilhável sem colar no chat ou e-mail.

A ferramenta lê do stdin ou de um caminho de arquivo, criptografa com AES-256-GCM na sua máquina, faz upload apenas do texto cifrado e imprime um URL com a chave de descriptografia no fragmento.

Notas criadas desta forma são rastreadas como creationSource: cli nas análises.

Instalar

Requer Node.js 18+. Funciona em macOS, Linux e 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

Experimentar ao vivo

O mesmo fluxo da CLI no navegador: criptografar localmente, enviar ciphertext, imprimir URL com a chave no fragmento.

Demo ao vivo — cria uma nota real em privatenote.ai. Use um segredo descartável, não credenciais de produção.

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

Arquitetura de segurança

O texto puro nunca sai da sua máquina sem criptografia. O URL de compartilhamento carrega a chave de descriptografia em seu #fragment, que navegadores e clientes HTTP não enviam para os servidores.

Quando o stdout não é um TTY (piped ou capturado), o CLI recusa-se a imprimir um link a menos que você passe --output-url-only ou --force-stdout — isso evita vazamentos acidentais em logs de CI.

Criptografar localmente

AES-256-GCM no seu dispositivo — navegador, editor, terminal ou processo MCP.

Enviar ciphertext

Apenas bytes criptografados e metadados da nota (validade, burn-after-reading) chegam ao servidor.

Chave em #fragment

A chave de descriptografia fica no hash da URL. Navegadores não enviam fragmentos em requisições HTTP.

privatenote.ai/note/…#key

Diagrama completo no hub de desenvolvedores
  • HTTPS necessário para origens API remotas; use --insecure apenas para dev local http:// (ex: wrangler dev em :8787).

  • PRIVATENOTE_ALLOWED_HOSTS fixa hostnames API ao usar uma base URL API personalizada.

  • Validação do formato da resposta e verificações de ID de nota reservado antes do upload.

  • Prefira redirecionar a saída para um arquivo com chmod 600 em vez de ecoar URLs.

Flags e variáveis de ambiente

NomeDescrição
--expire 15m|1h|24h|7dTempo de vida da nota (padrão: 24h)
--burn / --no-burnDestruir após a primeira visualização (padrão: burn)
--title <text>Título opcional prefixado ao conteúdo
--jsonImprimir { secureUrl, expiresAt, burnAfterReading }
--output-url-onlySaída apenas URL; seguro para stdout em pipes de scripts
--force-stdoutPermitir saída quando o stdout não for um terminal (use com --json em CI)
--api-base-url <url>Sobrescrever origem API (HTTPS; use com --insecure para http:// local)
--insecurePermitir origens API via http:// — apenas para dev local, nunca em produção
PRIVATENOTE_API_BASE_URLBase API padrão URL
PRIVATENOTE_WEB_ORIGINOrigem do link de compartilhamento (padrão: origem API)
PRIVATENOTE_ALLOWED_HOSTSLista de permissões de hostname separada por vírgulas

Integrações relacionadas

PrivateNote CLI

Segredos com zero pegada em scripts, pipes e CI — criptografados localmente antes de qualquer coisa chegar à rede.

Foto: Léna Le Roy · Unsplash.