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