uptrail

uptrail is a tiny Bun CLI for checking package compatibility in a project.

Install dependencies

bun install

Run tests

bun test

Verify before push

bun run verify

Run locally

bun run index.ts upgrade react@latest

You can also use commands and flags:

bun run index.ts upgrade react@19
bun run index.ts upgrade react@latest --llm
bun run index.ts upgrade react@latest --all
bun run index.ts adopt react-router@latest
bun run index.ts adopt react-router@latest --llm

Commands:

• upgrade: checks which installed packages may block upgrading to a package version
• adopt: checks whether a package's peer requirements fit the current project

Use --llm to print a concise plain-text brief that can be pasted into an LLM or coding agent. Use --all with upgrade to show the full report.

Install as a CLI

bun link
uptrail upgrade react@latest

Local git hook

This repo includes a dependency-free pre-push hook in .githooks.

Enable it once per local clone:

git config core.hooksPath .githooks
chmod +x .githooks/pre-push

The hook runs:

bun run verify