TypeScript refactoring built on ts-morph. AST-aware — safe renames, extractions, and reference finding across the entire codebase.
Finding Symbols
Search for functions, classes, or types:
bunx retype-cli search linearGraphQL -p ./src --list
bunx retype-cli search "create.*Component" --regex -p ./src --list
bunx retype-cli search myFunction --body -p ./src # Show code body
Finding References
See every usage of a symbol:
bunx retype-cli references linearGraphQL -p ./src --list
bunx retype-cli references linearGraphQL -p ./src --list --all # Don't truncate
Renaming
Preview changes before applying:
bunx retype-cli rename oldName newName -p ./src --preview
bunx retype-cli rename oldName newName -p ./src --yes # Apply without confirmation
bunx retype-cli rename oldName newName -p ./src --exact --yes # Exact match only
Extracting to New Files
Move a symbol to a different file, updating all imports automatically:
bunx retype-cli extract linearGraphQL ./src/api/linear.ts -p ./src --yes
Fixing Imports & Finding Unused Exports
bunx retype-cli fix-imports -p ./src # Fix missing imports
bunx retype-cli unused -p ./src --list # Find unused exports
Typical Workflow: Extract a Module
- Find the function:
bunx retype-cli search linearGraphQL -p ./src --list - Check references:
bunx retype-cli references linearGraphQL -p ./src --list - Extract to new file:
bunx retype-cli extract linearGraphQL ./src/api/linear.ts -p ./src --yes - Verify with typecheck
Typical Workflow: Rename Across Codebase
- Preview changes:
bunx retype-cli rename createComponent createWidget -p ./src --preview - Apply:
bunx retype-cli rename createComponent createWidget -p ./src --yes