> ## 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.

# Xpander Chat

> Xpander Chat, chat.xpander.ai on xpander cloud or your own domain when self-hosted, is the interface to the agents that run on xpander: conversations, tasks, approvals and sharing, on one screen for the whole team.

Xpander Chat is where the agents that run on xpander live, as opposed to a client on someone's laptop. On xpander's cloud it is [chat.xpander.ai](https://chat.xpander.ai), free to register; a Hybrid or Air-Gapped install serves the same app on your organization's own domain. It is one address for everyone in the organization. Team members use agents, assemble new ones and follow their work; admins additionally use **Platform**, the admin console (admins open it with **Open Platform** at the bottom of Settings), where the settings that govern every agent live, described on [Govern every agent](https://docs.xpander.ai/run/govern.md).

## Agents and conversations

The left column holds **New chat**, **Agents** (the agents shared with you, Omni the built-in agent, and **New** to assemble one), **Workflows**, [Surfaces](https://docs.xpander.ai/use/surfaces.md) and **Scheduled**. Below them, **Conversations** are grouped under **Today**, **Last week** and **Older**, with **Show all** to expand a group. Filters narrow them by agent, by user (**All users** shows teammates' conversations you have access to), **Source** (where the run started), **Status** and **Date**. **Status** includes **Scheduled**, for runs that have not happened yet. **See all conversations** opens the full list, with the same filters you set in the sidebar. While an agent works, **Notify me** on the status line tells you when it finishes. Pinned conversations are saved to your account, so they appear on every device you sign in on.

## A conversation

The header names the agent and the conversation, and shows who can see it: **Only you**, a group, or the organization, changed with **Manage access**. Several people can write in the same conversation; every message carries its author's name and every action is recorded under the person who asked for it.

The composer shows the harness and model the next message will run on, for example `Claude Code · Fable 5.1`, and the permission mode:

* **Automatically approve** runs every command the agent decides on. Only the agent's **gated commands** wait for approval.
* **Manually approve** holds every shell command, file edit and web fetch for approval; reads, searches and skills that are not themselves gated run unheld.

**Harness and model** opens the picker: the providers your organization enabled, with the number of models each offers, and every model listed with the harness it runs on. Switching keeps the conversation; the new harness receives the history. Which providers and models appear is set by admins under **Platform > AI governance > Models**.

## Tasks and the execution log

Every run is recorded as a task. The task panel shows the **execution log**: a counter of steps and actions, then one row per action with its status and time, such as `WebFetch`, `WebSearch`, a skill call, a shell command or `Task output`. Failed steps are marked. A stop button ends the run. Opening a turn in the **Session Manager** shows its details: status, steps, the number of calls the agent made, and duration, the user message, the result with **Export**, and the execution log. **Session Manager** (the list icon in the top bar) lists every task for an agent, filtered by **This agent**, **Users**, **Date**, **Status** or **Source**, and searchable by title or id. See [Tasks](https://docs.xpander.ai/use/agents/conversations.md#the-task-record).

![A failed turn in a conversation beside its Session Manager turn details: Done with its step, call and duration counts, the User message, and the Result with tags such as Failed and Exit code 1](https://mintcdn.com/xpanderai-099931d1/wqIIXSsh0kqA2hZ_/images/verify/use-app-2.png?fit=max\&auto=format\&n=wqIIXSsh0kqA2hZ_\&q=85\&s=0b8c1fb309cccb62995fcf90b3129263)

A turn opened in the Session Manager: status, steps, calls and duration, the user message and the result; the execution log follows below. Shown with sample data.

![Session Manager panel listing an agent's recent tasks with filter chips and a search box](https://mintcdn.com/xpanderai-099931d1/wqIIXSsh0kqA2hZ_/images/verify/use-app-1.png?fit=max\&auto=format\&n=wqIIXSsh0kqA2hZ_\&q=85\&s=6d825c23dc6ba2577a3686aaad980674)

Session Manager: every task for an agent, filtered by This agent, Users, Date, Status or Source, and searchable by title or id. Shown with sample data.

## Approvals

When an agent reaches an action that needs sign-off, the conversation shows a card with the action, its parameters and who started the run, with **Approve** and **Decline**. **Settings > Approvals**, in your own settings, lists what agents ask you under **Waiting for you** and your past decisions under **Decided**; it shows your approvals, not the organization's. If nobody decides within the agent's approval hold window (four hours by default), the held action does not run and the run continues. See [Approvals](https://docs.xpander.ai/use/approvals.md) and [Permissions and access](https://docs.xpander.ai/use/agents/permissions.md).

## Results, live surfaces and sharing

Files an agent creates are in its **Agent workspace**. **Make live** on a file turns it into a **live surface**: a page the agent keeps up to date on each run, listed on the agent's **Live surfaces** card and on the [Surfaces](https://docs.xpander.ai/use/surfaces.md) page. **Share** on a conversation offers the audience **Only you**, **Specific people or groups**, **Everyone at** your organization, or **Public**, and whether viewers may reply. Sharing the agent itself, with view, use or edit permission, is done from the agent's **Manage access**.

## Omni, the built-in agent

Omni is an agent that ships with xpander, one row in every organization's agent list. Ask it to find an agent or a skill, run a task, explain what a run did, or assemble a new agent from approved skills. It answers in Xpander Chat, in Slack, in Teams and by email, and it serves the MCP endpoint your own client connects to (see [Start here](https://docs.xpander.ai/use.md)). It is one agent among yours, not a separate product.

Each user has their own Omni. To reach yours from code, call [Get Omni Agent](https://docs.xpander.ai/api-reference/v1/agents/get-omni-agent.md) with a personal API key; it returns Omni's agent id, which works with every agent route of the API.

The Omni button in the bottom corner of the screen opens the [Omni sidekick](https://docs.xpander.ai/use/omni-sidekick.md). It is a floating chat window with Omni that sees the page you are on. For admins, it can also change organization settings after you confirm.

### Changes Omni proposes

Omni can suggest changes to an agent you may edit. It shows each change on a card first. Nothing changes until you approve it.

* **Improve instructions.** Ask Omni to improve an agent. Omni reads the agent's failed runs and the answers people marked down. It writes new instructions and shows a card with the old and new text side by side. Each finding on the card names the run it came from. When nothing failed, Omni says so and proposes no change.
* **Check the impact of a skill change.** Before you change or remove a shared skill, ask Omni which agents use it. Omni lists each agent, says whether its instructions mention the skill, and says whether it has a test suite. This check only reads. It changes nothing.

To approve, tell Omni to apply the change. On an agent that stages changes before publishing, the change becomes a draft that you test and [publish](https://docs.xpander.ai/use/agents/create.md#publish). On an agent that does not stage changes, it goes live at once. After a skill change, Omni can apply new instructions to up to ten affected agents at once and run each agent's test suite against them.

## Search and settings

**Search** (`⌘K`) sits at the top of every screen. The bell shows notifications, including approvals waiting for you. The gear opens **Settings**, your own:

* You: Profile, Notifications, Connections, Approvals
* Library: Skills, Knowledge bases
* AI: Memories, [AI models & keys](https://docs.xpander.ai/use/ai-models-and-keys.md), Usage

**Open Platform** leads admins to the organization's settings: **AI governance** (Usage, Logs, Models, Budgets, Policies, Audit log), **Agents** (Runtime, Channels, **Skills registry**, Secrets, Devices) and **Organization** (Members & groups, Access, Custom theme, License). These are described on [Govern every agent](https://docs.xpander.ai/run/govern.md).


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