# Retype

> Refactors TypeScript codebases with AST-aware rename, extract, and reference finding. Use for moving functions between files, renaming across codebase, or finding all usages of a symbol.

- Skill: `knoopx/retype` (Agent Skill)
- Install (CLI): `npx skillmds@latest add knoopx/retype`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knoopx/retype/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knoopx (https://skillmd.com/u/knoopx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/knoopx/retype

---


# retype-cli

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:

```bash
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:

```bash
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:

```bash
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:

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

## Fixing Imports & Finding Unused Exports

```bash
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

1. Find the function: `bunx retype-cli search linearGraphQL -p ./src --list`
2. Check references: `bunx retype-cli references linearGraphQL -p ./src --list`
3. Extract to new file: `bunx retype-cli extract linearGraphQL ./src/api/linear.ts -p ./src --yes`
4. Verify with typecheck

## Typical Workflow: Rename Across Codebase

1. Preview changes: `bunx retype-cli rename createComponent createWidget -p ./src --preview`
2. Apply: `bunx retype-cli rename createComponent createWidget -p ./src --yes`