SecureNote CLI

Create, view, and manage encrypted notes from your terminal

Use SecureNote From Your Terminal

SecureNote CLI is a single-binary companion for SecureNote. It lets you create encrypted notes from shell commands, files, scripts, or pasted text, then returns shareable SecureNote URLs that work in the regular web app.

Encryption and decryption happen locally on your machine before any request reaches securenote.app. The CLI derives keys with PBKDF2-SHA256, encrypts content with XChaCha20-Poly1305, and sends the server only encrypted data plus the metadata needed to store and expire the note.

The server stores the encrypted blob, salt, nonce, content type, expiry, and view-limit settings. Passwords stay client-side and are carried in the URL fragment after #, so the SecureNote server does not receive the password when a browser opens the link.

Create

Pipe text, pass an argument, or read a file. Choose Markdown or plaintext, expiry, view limits, and optional custom passwords.

Send the generated URL to someone else. The link can include delete access when you need to revoke the note later.

Read

View notes in text, raw, or JSON format, save decrypted output to a file, and integrate SecureNote into terminal workflows.

# Create a note from a pipe
echo "My secret" | securenote create

# Create a one-view plaintext note from a file
securenote create --file message.txt --content-type plaintext --max-views 1

# View and print only the decrypted content
securenote view <note-id> --password <password> --format raw

# See every command and option
securenote --help

Loading releases...

Installation

These commands install the latest CLI. Versioned downloads are available below if you need to pin a specific release.

macOS

Download and install the latest version:

# macOS (Apple Silicon)
curl -L https://securenote.app/downloads/latest/darwin-aarch64 -o securenote

# macOS (Intel)
curl -L https://securenote.app/downloads/latest/darwin-x86_64 -o securenote

# Make executable and install
chmod +x securenote
sudo mv securenote /usr/local/bin/

Linux

Download and install the latest version:

# Linux (x86_64)
curl -L https://securenote.app/downloads/latest/linux-x86_64 -o securenote

# Linux (ARM64)
curl -L https://securenote.app/downloads/latest/linux-aarch64 -o securenote

# Make executable and install
chmod +x securenote
sudo mv securenote /usr/local/bin/

Windows

Download and install using PowerShell:

# Download the latest version
Invoke-WebRequest -Uri https://securenote.app/downloads/latest/windows-x86_64.exe `
  -OutFile securenote.exe

# Move to a directory in your PATH
Move-Item securenote.exe C:\Windows\System32\