PrivateNote CLI
Segredos com zero pegada em scripts, pipes e CI — criptografados localmente antes de qualquer coisa chegar à rede.
Nesta página
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-onlyhttps://privatenote.ai/note/…#…
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
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
| Nome | Descrição |
|---|---|
| --expire 15m|1h|24h|7d | Tempo de vida da nota (padrão: 24h) |
| --burn / --no-burn | Destruir após a primeira visualização (padrão: burn) |
| --title <text> | Título opcional prefixado ao conteúdo |
| --json | Imprimir { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Saída apenas URL; seguro para stdout em pipes de scripts |
| --force-stdout | Permitir 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) |
| --insecure | Permitir origens API via http:// — apenas para dev local, nunca em produção |
| PRIVATENOTE_API_BASE_URL | Base API padrão URL |
| PRIVATENOTE_WEB_ORIGIN | Origem do link de compartilhamento (padrão: origem API) |
| PRIVATENOTE_ALLOWED_HOSTS | Lista de permissões de hostname separada por vírgulas |
Integrações relacionadas
Extensão do editor
Crie notas de VS Code, Cursor ou Codex IDE sem mudar de contexto. Use a barra lateral, um comando de texto selecionado ou a ação da barra de título.
Ver documentaçãoServidor MCP
Forneça a um cliente MCP uma ferramenta local que crie links PrivateNote quando um agente precisar entregar um segredo.
Ver documentaçãoPlug-in Codex
Instale o plug-in incluído para MCP plus skills ou adicione privatenote-mcp a ~/.codex/config.toml. Use a mesma extensão VS Code em Codex IDE para segredos que o agente nunca vê.
Ver documentaçãoExtensão Chrome
Criptografe texto selecionado em qualquer aba via menu de contexto, barra de ferramentas ou atalho — sem abrir o site.
Ver documentaçãoPrivateNote CLI
Segredos com zero pegada em scripts, pipes e CI — criptografados localmente antes de qualquer coisa chegar à rede.
