# See your changes

> How saving, the live view, preview links and your client's review copy fit together, and when to use each one.

You ask your assistant for changes in plain words. It saves each change for you, and when you want to look, it shows you the site. You never need to type a command. Nothing reaches your client or your live website until you ask.

## Two kinds of assistants

What you can see depends on one thing: whether your assistant can use your computer.

| | **Chat assistants** | **Computer assistants** |
| --- | --- | --- |
| Examples | Claude, ChatGPT and Gemini, in a browser or chat app | Claude Code, Codex, Google Antigravity, Cursor |
| What they can do | Talk with you and work on your site in Shortcake | The same, and run programs on your computer |
| Saved changes | Yes | Yes |
| Preview link | Yes | Yes |
| Live view | No | Yes |

Both are fine. A chat assistant shows your changes with a preview link, ready in about a minute. A computer assistant can also open a live view that changes within seconds. In the Claude desktop app, the chat is a chat assistant and the **Code** tab is a computer assistant.

## Four ways to see your site

### Saved changes

*Instant · no one can see them yet.*

Your edits, kept safe in Shortcake. Nothing is built or shown. This happens automatically every time you ask for a change.

### Live view

*A few seconds · only you, on your computer.*

Your site running on your own computer, changing as each edit is saved. Say *"Open my site live."* Computer assistants only.

### Preview link

*About a minute · anyone with the link.*

A web link to your saved changes. Open it on any device or send it to a colleague. Say *"Give me a preview link."*

### Review copy

*Made when you send for approval · only the approver.*

The exact, frozen version your client approves. Say *"Send this to my client for approval."* See [Client approval](/docs/client-approval).

The first three move with your edits. The review copy never changes after it is sent. That is what your client approves.

## What it looks like in a conversation

| You say | What happens |
| --- | --- |
| "Let's work on the Acme Bakery website." | Your assistant finds the site and the version you are working on. If it is unsure, it asks. |
| "Open my site live." | Computer assistants: your browser opens your site, and you get a link that starts with `http://localhost`. Chat assistants: you get a preview link instead. |
| "Make the headline bigger." | The change is saved. The open page updates within seconds. |
| "Give me a link I can open on my phone." | A preview link arrives in about a minute. |
| "Send it to my client for approval." | Your client gets an email with a protected review link. |

You can ask for changes at any point. Ask for a new preview link whenever you want it to include your latest edits.

## Before your first live view

A live view needs **Node.js 20 or newer** on your computer, a free program that runs it. If it is missing, your assistant can tell you how to install it from [nodejs.org](https://nodejs.org).

## The first time you open a live view (computer assistants)

- **Your assistant may ask permission to run something.** That is expected. The command starts with `npx @getshortcake/cli`. Allow it. Don't allow `npx shortcake` without `@getshortcake/`; that name belongs to an unrelated program.
- **Your browser opens the Shortcake sign-in page.** Sign in with your Shortcake email. You do this once per computer.
- **Your site's files are copied to a `Shortcake` folder** in your home folder. You don't need to open it. If you do edit a file there, it is saved to Shortcake automatically.

## Good to know

- **Saving is not publishing.** Saved changes, live views and preview links never change your live website. Only an approved and published version does.
- **Preview links may be public.** Anyone with the link can open it. Don't send it to people who shouldn't see unfinished work.
- **Neither one is approval.** Your client approves only through the emailed review link and a one-time code.
- **A version under review is locked.** While your client is reviewing a version, it can't change. Your assistant will tell you. You can keep working once they decide.
- **Stop the live view when you're done.** Say *"Stop the live view."* Your saved changes stay in Shortcake.

## Working on a client's site

If you build sites for clients, the steps are the same. Your client sees nothing from this page unless you send them a preview link. They approve only the review copy you send for approval. If you have access to several client workspaces, your assistant asks which one to use. Check the name before you continue.

## If something goes wrong

| What you see | What to do |
| --- | --- |
| Your assistant says it can't run programs on your computer. | It is a chat assistant. Ask for a preview link instead. |
| Your assistant asks you to type a command yourself. | Say *"Please run it for me."* If it still can't, use preview links. |
| Your assistant doesn't mention saving or preview links. | Its Shortcake tools are out of date. [Refresh the tools list](/docs/connect-your-ai-assistant#refresh-tools-after-an-update), then start a new chat. |
| The live view stopped updating. | Ask *"Is my live view still running?"* Your assistant can restart it. |
| A preview link takes more than a few minutes. | Ask *"What is the status of my preview link?"* If it failed, ask your assistant to fix the error, or [get help](/docs/get-help). |

<details>
<summary><strong>Technical details</strong> (optional)</summary>

Your assistant runs the Shortcake command-line tool, `@getshortcake/cli`, for you. You can also run it yourself in a terminal.

| Command | What it does |
| --- | --- |
| `npx @getshortcake/cli login` | Opens the Shortcake sign-in page and remembers you on this computer. |
| `npx @getshortcake/cli dev --site "Acme Bakery"` | Starts the live view and opens it in your browser. Add `--workspace` if you have several workspaces, or `--release` to open a specific version. |
| `npx @getshortcake/cli status` | Shows whether the live view is running and its address. |
| `npx @getshortcake/cli preview` | Turns your saved changes into a preview link. |
| `npx @getshortcake/cli stop` | Stops the live view. |
| `npx @getshortcake/cli logout` | Signs this computer out. |

- The live view uses port `4321`, or the next free port. Always use the address it prints.
- Site files are kept in `~/Shortcake/<site name>`. Logs are in that folder's `.shortcake` folder: `dev.log` for the tool and `astro.log` for the site.
- On a Mac, your sign-in is kept in the Keychain. Elsewhere it is kept in a file only your user can read.
- Protected files, such as build settings, secrets and lock files, are never saved from your computer.
- The tool cannot send anything to your client, approve or publish.

</details>
