retype-cli

TypeScript refactoring CLI built on ts-morph. AST-aware, safe refactoring.

Commands

Command Purpose

search

Find entities (functions, classes, types)

rename

Rename entity across all files

extract

Move entity to different file

references

Find all usages of an entity

unused

Find unused exports

fix-imports

Fix missing imports

Search

Find function by name

bunx retype-cli search linearGraphQL -p ./src --list

Find exported functions only

bunx retype-cli search --kind function --exported -p ./src --list

Find by regex pattern

bunx retype-cli search "create.*Component" --regex -p ./src --list

Show code body

bunx retype-cli search myFunction --body -p ./src

References

Find all usages of a function

bunx retype-cli references linearGraphQL -p ./src --list

Show all references (not truncated)

bunx retype-cli references linearGraphQL -p ./src --list --all

Rename

Rename with preview (dry run)

bunx retype-cli rename oldName newName -p ./src --preview

Rename without confirmation

bunx retype-cli rename oldName newName -p ./src --yes

Exact match only

bunx retype-cli rename oldName newName -p ./src --exact --yes

Extract

Move entity to a different file, updating all imports automatically.

Extract function to new file

bunx retype-cli extract linearGraphQL ./src/api/linear.ts -p ./src --yes

Interactive extraction

bunx retype-cli extract myHelper ./src/utils/helpers.ts -p ./src

Fix Imports

Find and fix missing imports

bunx retype-cli fix-imports -p ./src

Unused Exports

Find unused exported entities

bunx retype-cli unused -p ./src --list

Common Workflows

Extract API to separate module

1. Find the function

bunx retype-cli search linearGraphQL -p ./src --list

2. Check current references

bunx retype-cli references linearGraphQL -p ./src --list

3. Extract to new file (updates all imports)

bunx retype-cli extract linearGraphQL ./src/api/linear.ts -p ./src --yes

4. Verify

bun run typecheck

Rename across codebase

1. Preview changes

bunx retype-cli rename createComponent createWidget -p ./src --preview

2. Apply changes

bunx retype-cli rename createComponent createWidget -p ./src --yes

Clean up unused exports

1. Find unused

bunx retype-cli unused -p ./src --list

2. Review and remove manually

Options

Option Description

-p, --path

Project root path

-c, --config

Path to tsconfig.json

--list

Output as simple list

--yes

Skip confirmation

--preview

Dry run (rename only)

--exact

Exact match (rename only)

--all

Show all results (references)

vs ast-grep

Task retype-cli ast-grep

Rename symbol ✅ Best ⚠️ Manual

Extract to file ✅ Best ❌ No

Update imports ✅ Auto ⚠️ Manual

Find references ✅ Best ✅ Good

Pattern-based search ⚠️ Limited ✅ Best

Multi-language ❌ TS only ✅ Many

Complex rewrites ❌ No ✅ Best

Use retype-cli for: TypeScript refactoring (rename, move, extract) Use ast-grep for: Pattern matching, multi-language, complex rewrites