How It Works
Pith sits between your version-control host and your documentation files. It listens for events, runs specialised AI agents per doc type, and opens a PR with the result.
Event received
A webhook fires when a PR is approved or merged (GitHub / GitLab) or when your CI calls the API trigger. Pith verifies the signature and extracts the diff.
Run created
A DocRun record is created atomically with a quota check. If your monthly limit is already reached the run is queued and retried when space opens up.
Agents execute
Each enabled doc type has a dedicated AI agent (README, API, architecture, changelog). Agents read the diff, your existing docs, and your templates, then produce updated content.
Pull request opened
Pith opens a PR with the updated documentation files. A comment is posted to the source PR so your team can follow the link directly.
When using the CLI, steps 1-2 happen locally (git diff + config load) and the agents call the Anthropic API directly.
Ready to stop writing docs by hand?
Connect your first repository and Pith will handle the rest.