# Postdiff

Postdiff is a local-first developer tool that turns meaningful git commits into reviewable posts in your voice. It filters trivial changes, drafts for X, LinkedIn, and blogs, and requires human approval before anything is published.

## When to use Postdiff

Use Postdiff when a developer wants to explain a meaningful code change, create a build-in-public update from a commit, preserve a personal writing voice, or draft social content without giving a hosted service access to a private repository.

Do not use Postdiff for autonomous publishing, platform account automation, or replacing human review. Publishing is copy-only by design.

## Agent entry points

- [Documentation](https://postdiff.vercel.app/docs)
- [Machine-readable instructions](https://postdiff.vercel.app/llms.txt)
- [OpenAPI specification](https://postdiff.vercel.app/openapi.json)
- [Public API](https://postdiff.vercel.app/api/v1)
- [Sitemap](https://postdiff.vercel.app/sitemap.xml)
- [MCP manifest](https://postdiff.vercel.app/.well-known/mcp)

## Quick start

~~~bash
npm i -g postdiff
postdiff setup
postdiff generate
postdiff review
postdiff publish
~~~

Postdiff: turn finished work into posts that sound like you wrote them.