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

# mv

> Move or rename a file or directory in the workspace

The `mv` command moves or renames a file or directory in your workspace.

```bash theme={null}
dv mv --src_path <src_path> --dst_path <dst_path> [--workspace_id <workspace_id>]
```

**Required Parameters:**

* `--src_path` - The path to the file or directory to move
* `--dst_path` - The destination path

**Optional Parameters:**

* `--workspace_id` - The ID of the workspace to perform the move in (defaults to current workspace)

This command is useful for reorganizing your workspace structure or renaming files programmatically.

An example of moving a file:

```bash theme={null}
dv mv --src_path /old/location/file.txt --dst_path /new/location/file.txt
```

An example of renaming a file:

```bash theme={null}
dv mv --src_path /assets/old_name.png --dst_path /assets/new_name.png
```

An example of moving a directory:

```bash theme={null}
dv mv --src_path /game/old_folder --dst_path /game/new_folder
```

<Note>
  After using `mv`, you'll still need to commit the changes to save the move or rename to your branch.
</Note>