A modern command-line interface for Standard Notes
- 📋 Notes & Tasks: Create, edit, and manage notes and checklists
- 🏷️ Tags: Organize content with flexible tagging
- 📊 Statistics: Detailed analytics about your notes and usage
- 🔐 Secure Sessions: Keychain integration for macOS and Linux
- ⚡ Fast Sync: Efficient synchronization with Standard Notes servers
- 🔄 Multi-Platform: Windows, macOS, and Linux support
Download the latest release:
# macOS/Linux
curl -L https://github.com/jonhadfield/sn-cli/releases/latest/download/sncli_$(uname -s)_$(uname -m) -o sn
chmod +x sn && sudo mv sn /usr/local/bin/
# Or via direct download
# Visit: https://github.com/jonhadfield/sn-cli/releases# See all available commands
sn --help
# Add a note
sn add note --title "My First Note" --text "Hello, Standard Notes!"
# List your notes
sn get notes
# View statistics
sn stats| Command | Description |
|---|---|
add |
Add notes, tags, or tasks |
delete |
Delete items by title or UUID |
edit |
Edit existing notes |
get |
Retrieve notes, tags, or tasks |
tag |
Manage tags and tagging |
task |
Manage checklists and advanced checklists |
stats |
Display detailed statistics |
session |
Manage stored sessions |
register |
Register a new Standard Notes account |
resync |
Refresh local cache |
wipe |
Delete all notes and tags |
Note: Export and import are temporarily disabled due to recent Standard Notes API changes
export SN_EMAIL="your-email@example.com"
export SN_PASSWORD="your-password"
export SN_SERVER="https://api.standardnotes.com" # Optional for self-hostedStore encrypted sessions in your system keychain:
# Add session (supports 2FA)
sn session --add
# Add encrypted session
sn session --add --session-key
# Use session automatically
export SN_USE_SESSION=true
# or
sn --use-session get notes- 🔐 Fixed: Authentication issues with updated dependencies
- 🏷️ Improved: Tag cloud visualization with offline support
- 🛡️ Enhanced: Network error handling and graceful degradation
- 🐛 Fixed: Tag reference matching and display issues
- 💾 Added: Backup and restore functionality
- 📤 Added: Enhanced export with multiple formats
- 🎨 Added: Tag cloud visualization
- 📝 Added: Note templates system
# Create a note with tags
sn add note --title "Meeting Notes" --text "Important discussion points" --tag work,meetings
# Find notes by tag
sn get notes --tag work
# Create a checklist
sn add task --title "Todo List" --text "- Buy groceries\n- Call dentist\n- Finish project"
# View your note statistics
sn stats
# Edit a note
sn edit note --title "Meeting Notes" --text "Updated content"Tab completion is available for Bash, Zsh, Fish, and PowerShell.
Quick Install (Bash on macOS):
brew install bash-completion@2
sudo cp autocomplete/bash_autocomplete /usr/local/etc/bash_completion.d/sncli
echo '[ -f /usr/local/etc/bash_completion ] && . /usr/local/etc/bash_completion' >> ~/.bash_profile
source ~/.bash_profileQuick Install (Fish):
mkdir -p ~/.config/fish/completions
cp autocomplete/fish_autocomplete.fish ~/.config/fish/completions/sncli.fish📖 For detailed installation instructions for all shells, see autocomplete/README.md
export SN_SERVER="https://your-standardnotes-server.com"# Build from source
git clone https://github.com/jonhadfield/sn-cli.git
cd sn-cli
make build
# Run tests
make test
# View all make targets
make help- New accounts registered via sn-cli require initial login through the official web/desktop app to initialize encryption keys
Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- Standard Notes - The note-taking app this CLI supports
- Releases - Download the latest version
- Issues - Report bugs or request features