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

# Live Surfaces

> Real-time visual views of what your agents are doing.

Live Surfaces turn ongoing agent work into a visual view your team can open at any time - a dashboard, a brief, a status board - instead of reading chat or raw logs.

## What live surfaces can look like

A live surface can take many shapes depending on the workflow. Browse some common examples:

<Tabs>
  <Tab title="Invoice approval">
    An approval surface showing invoices awaiting review, amounts, and approve or reject actions.

    <Frame caption="Invoice approval live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/ZExbmT2Yknjn6o_V/images/image-66.png?fit=max&auto=format&n=ZExbmT2Yknjn6o_V&q=85&s=ccc97726f88fb322d5a4d619b7156290" alt="Invoice approval live surface" width="2968" height="5156" data-path="images/image-66.png" />
    </Frame>
  </Tab>

  <Tab title="PR review">
    A review surface summarizing open pull requests, risk, and recommended actions.

    <Frame caption="PR review live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/ZExbmT2Yknjn6o_V/images/image-63.png?fit=max&auto=format&n=ZExbmT2Yknjn6o_V&q=85&s=af066131dd160b635b8cfdb367ea8cac" alt="PR review live surface" width="3000" height="5516" data-path="images/image-63.png" />
    </Frame>
  </Tab>

  <Tab title="Deal review">
    A surface for reviewing deals - stage, value, risk signals, and next steps.

    <Frame caption="Deal review live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/ZExbmT2Yknjn6o_V/images/image-64.png?fit=max&auto=format&n=ZExbmT2Yknjn6o_V&q=85&s=ff98802bfdb482967fd149de8d227949" alt="Deal review live surface" width="2992" height="5540" data-path="images/image-64.png" />
    </Frame>
  </Tab>

  <Tab title="Candidate screen">
    A screening surface summarizing candidates, fit, and recommended next actions.

    <Frame caption="Candidate screen live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/ZExbmT2Yknjn6o_V/images/image-65.png?fit=max&auto=format&n=ZExbmT2Yknjn6o_V&q=85&s=06a4fe65c9ed1f8849d1cbc887630849" alt="Candidate screen live surface" width="2992" height="5276" data-path="images/image-65.png" />
    </Frame>
  </Tab>

  <Tab title="Usage report">
    A usage view of activity, volume, cost, and trends over time.

    <Frame caption="Usage report live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/p0vu664ZqhcInzjp/images/image-42.png?fit=max&auto=format&n=p0vu664ZqhcInzjp&q=85&s=01672091e1746b1167b8559fa011702a" alt="Usage report live surface" width="1082" height="1092" data-path="images/image-42.png" />
    </Frame>
  </Tab>

  <Tab title="Daily brief">
    A morning brief that pulls together priorities, highlights, and anything that needs attention.

    <Frame caption="Daily brief live surface.">
      <img src="https://mintcdn.com/xpanderai-099931d1/ZExbmT2Yknjn6o_V/images/image-61.png?fit=max&auto=format&n=ZExbmT2Yknjn6o_V&q=85&s=c6b197d9076f5e2f95ff12b3635a5fa9" alt="Daily brief live surface" width="1162" height="1404" data-path="images/image-61.png" />
    </Frame>
  </Tab>
</Tabs>

## Why they matter

Many agents do work in the background.

Live Surfaces make that work inspectable. You can see what ran, what changed, what failed, and what needs attention without asking the agent to explain everything from scratch.

## How they work

A live surface is usually backed by generated data and a reusable visual template.

For example, an agent can create a fresh data file for today's morning brief and render it through the same HTML template every time. The surface stays consistent, while the data changes for each run.

## When to use live surfaces

Live Surfaces are useful when the output is easier to understand visually than as chat text.

Use them for dashboards, status reports, task lists, summaries, monitors, and recurring briefs.

## Regeneration

Some surfaces represent a point-in-time snapshot.

If the data becomes stale, the agent can regenerate the surface, update the underlying data, or create a new shareable version.
