# @raycast/migration

> Tool to automate the migration to a newer version of the @raycast/api

Latest version **1.103.0** (published 2025-09-18) · MIT license · 0 weekly downloads

## Install

```sh
npm install @raycast/migration
pnpm add @raycast/migration
yarn add @raycast/migration
bun add @raycast/migration
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 1.103.0 |
| Published | 2025-09-18 |
| First published | 2022-02-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7757 |
| Author | mathieudutour |
| Maintainers | thomaspaulmann, mathieudutour, sxn, grzegorzkrukowski_raycast, raycastbot, pitnikola, samuelkraft, danielraycast |

## Links

- npm: https://www.npmjs.com/package/@raycast/migration
- Repository: https://github.com/raycast/extensions
- Homepage: https://github.com/raycast/extensions#readme
- Issues: https://github.com/raycast/extensions/issues
- npm.io page: https://npm.io/package/@raycast/migration

## Recent versions

- 1.103.0 (latest) — 2025-09-18
- 1.102.0 — 2025-09-12
- 1.94.0 — 2025-03-19
- 1.93.0 — 2025-02-26
- 1.91.0 — 2025-02-05
- 1.79.0 — 2024-07-17
- 1.78.0 — 2024-07-04
- 1.77.0 — 2024-06-19
- 1.76.0 — 2024-06-06
- 1.74.0 — 2024-05-15
- 1.72.0 — 2024-04-24
- 1.71.0 — 2024-04-10
- 1.68.0 — 2024-02-21
- 1.67.0 — 2024-02-07
- 1.66.0 — 2024-01-27
- … 36 more at https://npm.io/package/@raycast/migration/versions

## README

# Automated migrations

Whenever possible, we provide tools to automate the migration to a newer version of the API using [codemods](https://github.com/facebook/jscodeshift).

To run the codemods, run the following command in your extension directory:

```bash
npx @raycast/migration .
```

It will detect the version of the API you were previously using and apply all the migrations that have been available since.

After running it, do go through the updated files and make sure nothing is broken - there are always edge cases.

---
_Source: https://npm.io/package/@raycast/migration · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._