Scriv review
A configurable CLI for assembling Markdown or RST fragments into releases.
Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026
Scriv is an open-source command-line changelog management tool for software developers. Contributors create timestamped fragments alongside code changes, then Scriv combines them into a project CHANGELOG at release time. It supports both Markdown and reStructuredText, making it suitable for teams whose documentation or release process uses either format. Self-hosted deployment and configurable fragment directories fit projects that want changelog work to remain in the source repository.
The published model is open source rather than a set of paid plans, so Scriv is positioned as a developer tool that teams run themselves. Its ecosystem connection is focused: GitHub support allows entries to create or update releases, while options or settings can add generated files to git automatically. Custom Jinja templates extend both new fragment creation and GitHub release output, and configurable categories, markers, and output files let a repository shape the generated document around its own conventions. Documentation is the listed support channel.
Scriv’s standout capability is the fragment workflow: contributors can create entries with `scriv create`, collect all or selected entries with `scriv collect`, and print collected changelog content when needed. Prerelease support and multiple output formats add flexibility, while the tool remains narrowly focused on changelog assembly rather than broader release automation. Teams that want commit- or pull-request-driven generation, built-in version bumping, or a graphical interface should choose another tool. Scriv fits solo developers through enterprise teams that are comfortable with a configurable CLI and a repository-centered process.
Scriv pros and cons
- Where it wins
- Aggregates timestamped fragments into Markdown or reStructuredText changelogs
- Customizes categories, directories, markers, files, and Jinja templates
- Creates or updates GitHub releases from changelog entries
- Where it doesn't
- Command-line workflow is centered on a source repository
- Uses fragments as input rather than commits or pull requests
- Does not provide version bumping
Scriv fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update