supernote-cli: open source terminal tool for bulk exporting notes, annotations, and transcripts
Hey r/supernote,
I love my Nomad. It's my main line of defense for distraction-free thinking. But I’ve always found the pipeline for getting my notes off the device to be a bottleneck.
The Supernote Partner desktop app is awkward for bulk exports, and the old Python sync libraries I used to rely on no longer work. I wanted a way to automatically pipe my focused thinking directly into Obsidian and my AI workflows.
So, I built and open-sourced supernote-cli.
It's a terminal tool that fixes the plumbing and adds a few workflow conveniences. Here’s what you can do with it:
1. Extract notebooks and transcripts
List your notebooks and dump the on-device text recognition right to your terminal.
$ supernote notebook ls --limit 3
$ supernote nb [NOTEBOOK_ID]
2. Extract handwritten annotations from PDFs/EPUBs
List your annotated documents, extract your handwritten highlights/notes, and transcribe them (I use a local VLM for this).
$ supernote annotation ls --limit 4
$ supernote an [ANNOTATION_ID]
3. Extract action items using custom prompts
You can pass a custom prompt to extract specific things. For example, pulling out anything marked with a checkbox (☐) into a clean list:
$ supernote nb [NOTEBOOK_ID] --prompt "Whenever you see a line beginning with ☐, transcribe it..."
Links:
- GitHub repo (installation & docs): https://github.com/borismus/supernote-cli
- Blog post (more on the philosophy/why I built it): supernote-cli: pen, paper, and a pipe
It's extracted from my personal note-management setup, but it's generic enough now that it should be useful for anyone trying to build automated workflows around their Supernote. Let me know if you try it out or hit any bugs!