What is type-tune?

type-tune moves shared TypeScript types without making you chase every import by hand.

The Rust-powered CLI follows three deliberate steps:

Scan, plan, apply

Review the plan first; only the moves you approve are applied.

A crab sorts types on a conveyor belt

Install

Add type-tune to a project that uses Node.js 22+. A one-off scan is npx type-tune scan --project tsconfig.json. After a local install, run pnpm exec type-tune or npx type-tune.

See supported platforms and the first scan

pnpm add -D type-tune

Workflow

Scan your project, approve candidates in plan.md, and preview the rewrite before keeping it. These commands use pnpm exec after a local pnpm install. With npm, use npx type-tune and the same arguments.

View the complete workflow
pnpm exec type-tune scan --project tsconfig.json
pnpm exec type-tune apply --plan .type-tune/plan.json --markdown .type-tune/plan.md --dry-run