# Try the demo

> Connect your own computer (macOS, Linux or Windows) to a live Uncage site with one command, ask for a landing page, and watch your own Claude Code build it and publish it through the site's tools, with approval cards in the browser.

<!-- https://uncage.vercel.app/docs/start/try-the-demo/ -->

The demo is a small website built with Uncage (the [`connected-demo` example](https://github.com/ptmafia/uncage/tree/main/examples/connected-demo)). You connect your own computer to it and ask for a landing page. Your own Claude Code builds the page on your computer and publishes it to the site through the site's tools, and you approve the steps in the browser. It takes about five minutes.

The demo's interface is in Chinese. This page gives each label with its meaning, for example **允许执行** (Allow once).

## Before you start

- A computer with macOS, Linux or Windows. Node.js 22 is not needed up front: the command below installs it if it is missing.
- Claude Code installed and signed in: `curl -fsSL https://claude.ai/install.sh | bash` (macOS, Linux) or `irm https://claude.ai/install.ps1 | iex` (Windows PowerShell), then run `claude` once and type `/login`.

## Sign in as a guest

Open the demo and click **以访客身份进入** (Enter as a guest). The site gives this browser a random guest account; there is nothing to sign up for. The chat then shows **连接你的电脑** (Connect your computer) with one command, on the tab of your operating system.

*(Screenshot: The demo's chat with the card 连接你的电脑: under 在你的电脑上运行这条命令 (Run this command on your computer), the tabs macOS / Linux and Windows and the curl command with the demo's address; below it, 已经装好 CLI？ (Already have the CLI?) with the uncage setup command, and a line saying it is waiting for the computer to come online.)*

## Connect your computer

In a terminal (PowerShell on Windows), run the command the card shows, with the demo's address in place of `<demo>`:

```sh
curl -fsSL <demo>/api/uncage/install.sh | bash        # macOS, Linux
irm <demo>/api/uncage/install.ps1 | iex               # Windows PowerShell
```

It checks your computer and asks `[Y/n]` before installing anything that is missing (Node.js 22, the Uncage CLI); see [Install on your computer](https://uncage.vercel.app/docs/start/install-on-your-computer.md). At the end, answer **Y** to run `uncage setup` for the demo. Already have the CLI? Run `uncage setup <demo>` instead. Setup prints a code and opens the demo's approval page in your browser.

*(Screenshot: The approval page 连接这台电脑? names the computer asking to connect, shows the 验证码 (verification code) in large letters, and offers 拒绝 (Deny) and 批准 (Approve).)*

*Check that the **验证码** (verification code) matches the one in your terminal, then click **批准** (Approve). The chat shows your computer's name with a green dot: it is online.*

## Ask for a landing page

Send, for example, 「做一个介绍 Uncage 的落地页并发布」 ("build a landing page about Uncage and publish it"). Claude Code runs on your computer, under your own login, in a folder of its own under `~/Uncage/`. It loads the site's `landing-page` skill, calls the site tool `create_asset`, writes the page, and then asks to run `publish_asset`.

*(Screenshot: The chat while the run is going: the steps Skill and mcp__site__create_asset with check marks, and Claude Code thinking about the next step.)*

*The steps appear in the chat as they happen. `mcp__site__create_asset` is the site's tool: it runs on the site's server, as your guest account, and needs no question.*

Claude Code asks before steps that its permission mode does not allow on its own (the composer shows **每次询问**, Ask every time), such as running a command or writing a file. `publish_asset` is defined with `requiresConfirmation`, so the site asks before every call, in every mode. Each question is an approval card, and the run waits until you answer.

*(Screenshot: An approval card for mcp__site__publish_asset, showing the call publish_asset with the asset ID and the folder landing, the working folder, and the buttons 拒绝 (Deny) and 允许执行 (Allow once).)*

*The approval card for `publish_asset`. Click **允许执行** (Allow once) or **拒绝** (Deny). After **允许执行**, the site copies the page's folder from your computer and publishes it. Steps such as a command or a file write get the same kind of card.*

*(Screenshot: The finished conversation: Claude Code's summary says the landing page is published at /assets, and describes the page's hero, features, how to start and closing sections, with 完成 (Done) and the time taken below.)*

*When the run is done, Claude Code summarizes what it built. The site's `landing-page` skill gives it the facts about Uncage to build from.*

## See the result on the site

Open **素材** (Assets, `/assets`). The published page is listed there; click it to see it in a sandboxed preview. The page lives on the website, not on your computer, and only you can open it.

*(Screenshot: The 素材 (Assets) page lists one landing page with the badge 已发布 (Published).)*

*(Screenshot: The asset's page in the sandboxed preview: a dark landing page headed 让网站驱动你自己的 Claude Code (Let your website drive your own Claude Code), with the badge 已发布 (Published).)*

Now close the lid, or stop the agent (`uncage agent uninstall` stops the background agent). The conversation stays readable, because the site keeps it, and the computer in the header turns offline. Run `uncage agent` to bring it back.

*(Screenshot: The end of the finished conversation, with a notice that the computer is offline and waiting to reconnect, which says to run uncage agent on that computer.)*

*The notice reads "你的电脑离线了，等待重新连接…" (Your computer is offline, waiting to reconnect).*

## About your data

- You are signed in to the demo as a guest, identified by the browser you use. Another browser sees none of your conversations or pages.
- The demo is public and shared. Running on a single server without a persistent volume, all of its data is cleared on every deploy and restart; on Vercel it is kept in Postgres. Either way, assets (the pages you create) are removed 24 hours after they were last created or published.
- Requests for a published page are owner-only: only your guest account can open it. The files the page loads are guarded by the page's unguessable ID.
- Do not put anything private in the demo.

To disconnect your computer when you are done, run `uncage sites` to list the sites it is connected to and `uncage sites remove <id>` with the demo's ID to remove it. See the [CLI reference](https://uncage.vercel.app/docs/reference/cli.md).

## Run the demo yourself

The demo's source is an ordinary Uncage Connected Mode site with two entry points over the same tools, skills and pages: `server.ts` for traditional mode (one Node process, for example on Railway) and a Next.js route handler for FaaS mode (Vercel, with Postgres). To run it on your own machine, follow [the example's README](https://github.com/ptmafia/uncage/tree/main/examples/connected-demo#run-it-single-node). To build your own, continue with [Quickstart: Connected Mode](https://uncage.vercel.app/docs/start/quickstart-connected.md), and see [Choose a deployment mode](https://uncage.vercel.app/docs/start/choose-deployment-mode.md) for where to host it.
