Bumpgen is an open-source AI agent developed by Xeol that automates the process of upgrading npm packages in TypeScript and TSX codebases. Rather than simply bumping a version number, it detects and repairs the breaking changes that the upgrade introduces, committing the fixes directly to the codebase or pull request branch. The tool works by using ts-morph to parse the project into an abstract syntax tree (AST), which lets it understand the relationships between code statements and retrieve accurate type definitions for external library methods. When a breaking change is detected after a version bump, bumpgen uses this structural understanding to determine how the new API should be called. Bumpgen implements a 'plan graph' approach (inspired by Microsoft's CodePlan research) that propagates fixes through the codebase: if fixing one call site introduces a second-order breakage elsewhere, bumpgen continues resolving those cascading failures rather than stopping at the first fix. The plan graph, the error context, and the affected file are all passed together to the LLM to maximize fix quality. It integrates with CI/CD workflows via a GitHub Action, and is designed to be triggered by Dependabot or Renovate pull requests. When a dependency PR opens, the action detects any build failures caused by the bump and commits the necessary code changes back to the PR branch. As of the available documentation, GPT-4 Turbo Preview (OpenAI) is the primary supported LLM, with a Xeol API key also used via a beta sign-up program. The project is fully open source on GitHub under the xeol-io organization. Key features: - AST-based code understanding using ts-morph for accurate type-aware refactoring - Plan graph propagation to fix cascading second-order breaking changes - GitHub Action for CI/CD integration, triggerable on Dependabot/Renovate PRs - Commits auto-generated fixes directly to the dependency PR branch - Supports TypeScript and TSX projects (other strongly-typed languages planned) - Uses LLM (GPT-4 Turbo) with full error context and AST type info for high-quality fixes - Open source under MIT license on GitHub (xeol-io/bumpgen) - CLI usage: run bumpgen with a package name and target version
Open source (free). Requires an OpenAI API key (GPT-4 Turbo). A Xeol-hosted beta with a Xeol API key was available via sign-up at xeol.io/beta; pricing for that tier not publicly listed.
