# Remix & rename

> Fork a prototype into a new project, keep working on the same one, or rename it.
> URL: https://artor.app/docs/remix

There are two different things you can do with an existing prototype, and they're easy to
mix up: **keep working on the same project** (ship its next version), or **fork it** into
a brand-new project that's yours.

| You want to… | Command | Result |
| ------------ | ------- | ------ |
| Keep working on the **same** project | `artor pull` | Stays linked; your next publish is version N+1 |
| **Fork** into a new project you own | `artor remix` | New project, records where it came from |
| Change the **display name** | `artor rename` | Name only; URL and folder unchanged |

You need a [publisher seat](https://artor.app/docs/seats), access to the source prototype, and the
[CLI installed](https://artor.app/docs/install-cli). Run these commands from a linked project folder.

## Remix: fork into a new project

```bash
artor remix acme-dashboard                  # prompts for a name
artor remix acme-dashboard my-variant       # name it directly
artor remix acme-dashboard --ref 2          # fork from version 2
```

Remix creates the folder for you, downloads the source, and creates a new project with you
as the owner. The fork is fully independent; publishing in the new folder never touches
the original.

On the dashboard you'll see a **"Forked from acme-dashboard v3"** line linking back to
the exact version you started from.

## Rename: change the display name

```bash
artor rename "New Name"               # owner or org admin only
artor rename acme-dashboard "Acme V2" # owner or org admin only
```

Rename changes only the display name. The URL and your local folder don't move. Only the
owner or an admin can rename.

## Delete & recover

Deleting moves the prototype to **Trash**, where it is recoverable for
**30 days** before it's permanently removed.

```bash
artor rm                     # owner or org admin only; asks to confirm
artor rm acme-dashboard      # owner or org admin only
artor trash                  # list what's in the trash and how long each has left
artor restore acme-dashboard # owner or org admin only
```

These actions require the prototype owner or an org admin with permission to edit its Space.
The content stops being served immediately but isn't gone. `restore` brings everything back.

**You cannot publish to a trashed project** — restore it first, so you
never pile up versions that can't serve.

In the dashboard, the **⋯ menu** on each prototype offers the same actions: rename, disable,
trash, and restore. Disabling and trashing **always confirm**, and trashing requires you to
**retype the prototype's name** before it goes through. _Copy latest link_ is available to any
member.

## See also

- [CLI reference](https://artor.app/docs/cli)
- [Access control](https://artor.app/docs/access)
