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

# Playground

> Chat with a real model running your app

![Playground](https://docs.skybridge.tech/images/playground.webp)

Putting a real model in the loop normally means registering your app in a host. The Playground skips that: a chat wired to your local server, where a real LLM uses your [tools](https://docs.skybridge.tech/build/tools.md) and the [views](https://docs.skybridge.tech/build/view.md) render inline.

## Start the Playground

The Playground comes with the [tunnel](https://docs.skybridge.tech/test/tunnel.md). Start it with the `--tunnel` flag (or toggle **Tunnel** in the [DevTools](https://docs.skybridge.tech/test/devtools.md) header):

```bash npm theme={null}
npm run dev -- --tunnel
```

```bash pnpm theme={null}
pnpm dev --tunnel
```

```bash yarn theme={null}
yarn dev --tunnel
```

```bash bun theme={null}
bun dev --tunnel
```

```bash deno theme={null}
deno task dev --tunnel
```

Your local server becomes publicly available, and so does the Playground: it runs on the tunnel URL suffixed with `/try` (e.g., `https://cool-marmot-fondue-420.alpic.dev/try`). Anyone with the link can open it from any browser and chat with your app.

## Exercise the Model Loop

With a model in the loop, the prompt surface and the state sync become testable:

![Playground Illustration](https://mintcdn.com/skybridge-alpic/RtZa8OS665SGx8s1/images/playground-screenshot.png?fit=max\&auto=format\&n=RtZa8OS665SGx8s1\&q=85\&s=f64de0ae546ae0214b15224594792a31)

The Playground interface

* **Tool selection**: assess what the model understands from your [tool names and descriptions](https://docs.skybridge.tech/api-reference/register-tool.md#name-title-description).
* **Argument filling**: check how it fills inputs from your [schemas](https://docs.skybridge.tech/api-reference/register-tool.md#inputschema-outputschema).
* **Narration**: see how it presents your tool [outputs](https://docs.skybridge.tech/api-reference/register-tool.md#return) in the conversation.
* **State**: verify what it picks up from the view [state](https://docs.skybridge.tech/build/state.md) on its next turn.

## Limitations

* Host specifics (model behavior, [state push policies](https://docs.skybridge.tech/build/state.md#decide-who-sees-what), view feature support) still need a real host: connect your app to ChatGPT and Claude using the [tunnel](https://docs.skybridge.tech/test/tunnel.md).
* The playground runs on [Alpic](https://docs.alpic.ai/distribution/playground): check the [host compatibility matrix](https://docs.skybridge.tech/api-reference/overview.md#hooks) for which hooks it supports.

## Go Further

> [card] [DevTools](https://docs.skybridge.tech/test/devtools.md)
>
> Call tools and render views locally, without a host

> [card] [Tunnel](https://docs.skybridge.tech/test/tunnel.md)
>
> Expose your local server to real hosts

> [card] [Audit](https://docs.skybridge.tech/test/audit.md)
>
> Catch spec and platform issues before submission


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.