Repo

Free

bumpgen bumps your TypeScript / TSX dependencies and makes code changes for you if anything breaks.

FreeFree tier

Type

Open Source

Visit Website GitHub (40 stars)

About Repo

Bumpgen is an AI agent that automates upgrading npm packages by making necessary code changes when breaking changes occur. It works by building the project to detect what broke after a dependency bump, then uses ts-morph to create an abstract syntax tree (AST) from the code to understand relationships between statements and type definitions. It creates a plan graph DAG to execute changes in the correct order, propagating fixes. Currently supports TypeScript and TSX dependencies. Bumpgen can be used via CLI or as a GitHub Action, ideally triggered on Dependabot or Renovatebot pull requests. Requires an OpenAI API key with the gpt-4-turbo-preview model. It is open source and free to use.

Key Features

Automates npm package version bumps with automatic code changes for breaking updates

Uses ts-morph to create an abstract syntax tree (AST) for understanding code relationships and type definitions

Creates a plan graph DAG to execute changes in the correct order

Supports CLI usage and GitHub Action integration

Designed to work with Dependabot and Renovatebot pull requests

Open source and free to use

Pros & Cons

Pros

Automates the tedious process of fixing code after breaking dependency updates
Integrates seamlessly with GitHub Actions and Dependabot/Renovatebot
Uses AST analysis for precise and context-aware code modifications
Open source with no licensing fees
Reduces manual effort and potential errors in upgrading dependencies

Cons

Currently only supports TypeScript and TSX; no support for other languages yet
Requires an OpenAI API key with gpt-4-turbo-preview (paid model)
Limited to npm packages
Can be slow or resource-intensive due to AST processing and API calls

Best For

Upgrading npm packages with breaking changes in TypeScript/TSX projectsAutomating dependency updates in CI/CD pipelines via GitHub ActionsHandling complex propagation of code changes when updating package versions

FAQ

What dependencies does bumpgen support?

Currently bumpgen only supports TypeScript (TS) and TSX dependencies. Support for other strongly typed languages like Java, Go, C#, and Python is planned but not yet available.

How does bumpgen work?

Bumpgen builds your project to understand what broke when a dependency was bumped. It then uses ts-morph to create an abstract syntax tree (AST) from your code to understand relationships between statements and get type definitions for external methods. Finally, it creates a plan graph DAG to execute changes in the correct order to handle propagating changes.

Do I need an API key to use bumpgen?

Yes, you need an OpenAI API key. Bumpgen currently only supports the gpt-4-turbo-preview model from OpenAI.

Can I use bumpgen in CI/CD?

Yes, bumpgen provides a GitHub Action that can be triggered on Dependabot or Renovatebot pull requests. The action will commit changes to the PR branch if breaking changes are detected.