---
title: "ralphy migrate"
description: "One-pass migration of this root to the final layout: workspace/ tree → .ralphy/ root + workspaces (#108), per-project assets/ + refs/ → artifacts/ (#105). Idemp"
---

{/* Auto-generated — edit `cli/commands/<verb>.ts` instead. Regenerate via `bun run docs:cli`. */}

## Summary

```bash
ralphy migrate [options]
```

**Common flags**

| Flag | Description |
|---|---|
| `--dry-run` | Print the full move + rewrite plan without touching disk |
| `--project <id>` | Scope to one project's inner artifacts/ move only (requires |

<Expandable title="Full reference">

**Flags**

| Flag | Description |
|---|---|
| `--dry-run` | Print the full move + rewrite plan without touching disk |
| `--project <id>` | Scope to one project's inner artifacts/ move only (requires |
| `-h, --help` | display help for command |

</Expandable>
