By name: ripast
description: AST-aware rename, move, extract, find-usages, and tailwind/CSS class migration across TS/JS/Vue SFCs (incl. <template>). Use for any multi-file rename, move, import update, or refactor mechanical step. Prefer over Edit/grep whenever a change spans more than one file.
user_invocable: true
ripast is published on npm as @ripast/cli. Repo: https://github.com/harlan-zw/ripast
Invocation
npx -y @ripast/cli <command> ...
Or install once:
npm i -g @ripast/cli
ripast <command> ...
Requires rg (ripgrep) on PATH and Node 20.11+.
Commands
| Command | Use |
|---|---|
ripast scan <pattern> |
Classify every occurrence (identifier vs string vs property vs JSX). First call before any rename. |
ripast tree |
Project declaration tree. |
ripast unused |
Top-level declarations with zero project references. |
ripast rename <from> <to> |
Scope-aware symbol rename via ts-morph. |
ripast move <symbol> --from <a> --to <b> |
Move an export; rewrite all import sites. |
ripast rename-file <old> <new> |
Rename file + every importer (incl. .vue). |
ripast css-class-rename <from> <to> | --map <file.json> |
Tailwind/CSS token migration. |
ripast css-class-scan |
List class tokens (seeds a rename map). |
For Nuxt projects, pass --tsconfig .nuxt/tsconfig.json on tree/unused/rename/move/rename-file so auto-imported composables, utils, and components resolve. Run nuxi prepare first if .nuxt/ is missing.
Mutating commands default to dry-run (unified diff). Pass --apply to write. --verify (default on for rename/move) blocks --apply if new typecheck diagnostics appear; pass --no-verify to skip, or --verify-mode touched|project|none for explicit control. Pass --json for machine-readable output. --profile auto|agent|full controls verbosity (auto-detects agent envs via std-env).
When to use vs Edit
| Situation | Tool |
|---|---|
| Single site, or <5 matches in one file | Edit |
| "Where is X used?" | ripast scan |
| Rename a symbol across the repo | ripast rename |
| Move a declaration to another file | ripast move |
| Rename a file and update every importer | ripast rename-file |
| Migrate a tailwind/CSS class | ripast css-class-rename |
| Pattern only meaningful in strings/comments | plain rg + Edit |
When in doubt, start with scan — its output tells you which of rename/move/Edit fits.
Run npx -y @ripast/cli <cmd> --help for full flags.