> ## Documentation Index
> Fetch the complete documentation index at: https://ralphy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ralphy migrate

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

## Summary

```bash theme={"dark"}
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>