01
Set up once
Choose your provider, add your keys, and give Postdiff a few writing samples to work from.
// Docs
Quickstart
Postdiff runs where your code already lives. Install it, teach it how you write, then turn a meaningful commit into a reviewable post without handing over your repository.
npm i -g postdiff
postdiff setup
postdiff generateAgent resources
// Workflow
01
Choose your provider, add your keys, and give Postdiff a few writing samples to work from.
02
Run the command from a repository. Postdiff checks whether the change is worth sharing before it writes anything.
03
Edit, accept, or reject the draft in the terminal. Your decision can sharpen future drafts.
04
Once accepted, copy the draft to your clipboard and paste it wherever you publish. No account connection required.
// Commands
Command surface
Each command is explicit. Nothing runs in the background and no platform account is connected for you.
postdiff setupConfigure your name, keys, provider, model, and optional voice samples.
postdiff contextInspect the generation-ready context for a commit without calling a model.
postdiff generateDraft one format from the latest commit. Add --x, --linkedin, or --blog to choose it.
postdiff reviewRead, edit, accept, or reject the stored draft before it can be published.
postdiff publishCopy an accepted, hash-matched draft to your clipboard.
// Privacy model
Keep control
Voice samples, reference posts, preferences, drafts, and review history live under your local Postdiff directory. Only the context needed for a generation is sent to the provider you choose.
Start
Install it, run setup once, and turn your latest work into a first draft. Free while it runs on your own keys.