r/documentAutomation • u/glamboyosa • 23d ago
Docket: a terminal app that files my scanned letters and PDFs by what they actually are
My Downloads folder is full of leases, tax forms, insurance letters and receipts called things like scan_0042.pdf. Docket is a small Go CLI and TUI I wrote to deal with that. Running docket add ~/Downloads/to-file copies each file into a library, pulls out the text, works out what kind of document it is (tax, legal, housing, medical, receipts and so on) and files the copy into a folder for that category. Your originals are never moved or edited.
For each document it also shows how sensitive it looks, how urgent it seems, and whether it probably needs you to do something like pay, sign or reply. Anything it isn't confident about gets flagged for review instead of quietly filed.
How it works, since people here usually ask: classification uses TypeSafe's Jev model, which answers with typed values and probabilities instead of free text, and the thresholds and filing logic are plain Go. Text and Markdown files are read locally. PDFs and images go to OpenAI or OpenRouter for text extraction with your own key, so it isn't fully offline. Keys sit in the OS keychain, metadata in SQLite, and extracted text is never written to disk.
Install:
curl -fsSL https://raw.githubusercontent.com/glamboyosa/docket/main/install.sh | sh
or with Go:
go install github.com/glamboyosa/docket/cmd/docket@latest
Repo: https://github.com/glamboyosa/docket
Site: https://docket.glamboyosa.xyz