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

# View an agent's work as a live preview

> Use the working app an agent built for a task — right inside the task description.

When an agent finishes work with a visible interface, it can publish a **live
preview** — the actual running app with its change, served from the worker's
machine for up to 12 hours. The preview renders **directly inside the task
description**: open the task and the app is just there, interactive. No login
step, no setup — being a member of the workspace is what grants access.

<Note>
  Task previews are an opt-in feature in its testing phase. Turn them on in
  **Settings → General → Task previews**. Tasks without a published preview
  show nothing.
</Note>

## What you see on a task

A published preview appears as an embedded frame in the task description,
with a header above it stating:

* **what build it shows** — the branch and commit the agent delivered;
* **what data it contains** — always seeded demo data, never real customer
  data — and, if the app has its own login screen, the demo credentials to
  use;
* **when it expires**.

A small **Preview** chip also appears in the task's property row showing the
current state at a glance.

## Open the full preview

Select **Open full preview** on the frame (or the chip) to use the app in
its own browser tab — best for serious click-through, and it supports
everything the app can do, including real-time features. In some browsers
(Safari) the inline frame cannot display and shows an *Open full preview*
prompt instead; the full tab always works.

## Preview states — and what "best effort" means

Previews are hosted on the machine that ran the agent — often someone's
laptop. That is a deliberate trade-off: previews are instant and free, but
they are **best-effort**:

| State       | Meaning                                                                                                                      |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Live**    | Usable right now.                                                                                                            |
| **Offline** | The hosting machine is asleep or lost its connection. The preview may come back on its own; the card rechecks automatically. |
| **Expired** | The 12-hour window ended. Everything is cleaned up automatically.                                                            |
| **Revoked** | A member ended it early.                                                                                                     |

The task always shows the truth before you click — a dead preview is never
presented as a working link. When the agent runs again on the same task, a
new preview replaces the old one (old links stop working; the task itself is
always the up-to-date address).

## Revoke a preview

Any workspace member can end a preview early: select **Revoke** on the frame
and confirm. The link becomes unreachable within seconds, regardless of the
hosting machine's state. Turning the feature off in Settings revokes every
live preview in the workspace at once.

## Security, in brief

* Only workspace members can reach a preview — every request is checked at
  the network edge before it reaches the hosting machine. A bare URL pasted
  anywhere shows outsiders nothing.
* Previews run a production build against seeded demo data; the header on
  every preview states exactly what you are looking at.
* Preview pages are never indexed by search engines.