# Managing Cloud Agents

Warp provides a centralized management view where you can monitor agent activity across your account and (where applicable) your team. You can access this view in the Warp app or through the [Oz web app](https://docs.warp.dev/agent-platform/cloud-agents/oz-web-app) at [oz.warp.dev](https://oz.warp.dev), which works on mobile devices.

The management view is designed to answer, at a glance:

* Which agents have been running recently (and what's running right now)
* Which runs succeeded, failed, or were canceled
* Where an agent run was triggered from (a local agent conversation, the Oz CLI, Slack, etc.)
* How many credits those runs consumed

{% embed url="<https://www.loom.com/share/679c267ddd2d44519abf79edcb1122c7>" %}

This management view includes your **local (interactive) agents** and [cloud agent](https://docs.warp.dev/agent-platform/cloud-agents/overview) runs.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-0b4cbbfa20677123fd22890c8678a9b8604ac722%2Fmanagement-view-scannable-list.png?alt=media" alt=""><figcaption><p>Warp's management view showing interactive and cloud agent runs.</p></figcaption></figure>

### What appears in the management view

The management view includes two categories of agent activity.

#### Interactive agents

* Initiated from the Warp desktop app.
* The conversation is owned by you. It opens locally in Warp, and can be shared via a link when needed.
* Credit usage reflects inference.

#### Cloud agent runs

* Background executions initiated by triggers such as integrations and automations (for example: Slack, Linear, schedules, GitHub Actions, or API/CLI invocations).
* Each run produces a shared session that can be inspected after completion (including logs, messages, and outputs).
* Credit usage reflects inference + compute, shown as a single combined value in this view.

{% hint style="warning" %}
All usage rolls up into Warp's standard [**credit**](https://docs.warp.dev/support-and-community/plans-and-billing/credits) system.
{% endhint %}

In the **Personal** tab, you can view all of the interactive and cloud agent conversations that you own. In the **All** tab, you can see everything from the personal tab, as well as any cloud agent sessions that are shared with you by your teammates; right now, this only includes things triggered from integrations.

***

### The agents list

Each row represents a single item in the management view (either an interactive conversation or a cloud agent run). The list is intended to be scannable: you should be able to understand “what happened” without opening anything.

#### Fields you’ll see

**Source**

Where the agent was launched from. Common sources include:

* **Interactive:** an [agent conversation](https://docs.warp.dev/agent-platform/local-agents/overview) started in the Warp app
* **CLI**: a local run triggered by the [Oz CLI](https://docs.warp.dev/reference/cli/)
* **API**: a run triggered by [Warp's API](https://docs.warp.dev/reference/api-and-sdk/agent)
* **Slack / Linear**: runs triggered by [integrations](https://docs.warp.dev/agent-platform/cloud-agents/integrations)
* **Scheduled**: runs triggered on a [cron schedule](https://docs.warp.dev/agent-platform/cloud-agents/triggers/scheduled-agents)

**Status**

Warp uses a small set of statuses to help you quickly identify what needs attention:

<table><thead><tr><th width="173.375">Status</th><th width="78.41973876953125">Icon</th><th>Description</th></tr></thead><tbody><tr><td><code>Working</code></td><td>N/A</td><td>in progress (may include queued / running states)</td></tr><tr><td><code>Blocked</code></td><td>🟨</td><td><p><em>(interactive only)</em></p><p><br>the conversation is waiting on user input or a required step</p></td></tr><tr><td><code>Canceled</code></td><td>⬜️</td><td>(interactive only)<br><br>the interactive conversation was canceled before completion</td></tr><tr><td><code>Failed / Errored</code></td><td>🔺</td><td>something went wrong (applies to both interactive and cloud agent runs)</td></tr><tr><td><code>Success</code></td><td>✅</td><td>completed successfully (applies to both interactive and cloud agent runs)</td></tr></tbody></table>

**Duration (for cloud agent tasks)**

* Shown for cloud agent runs to indicate how long the task executed.
* Note: Interactive conversations generally don’t map cleanly to a single “run duration,” so this is currently omitted.

***

### Inspecting an agent

**The primary interaction is simple:**

* Clicking a cloud agent row opens the [shared session](https://docs.warp.dev/agent-platform/cloud-agents/viewing-cloud-agent-runs) for that run (logs/messages/output).
* Clicking an interactive row opens the conversation locally in the Warp app.

This makes the management view a navigation surface: find the thing you care about, click once, and you’re in the right context to inspect or continue work.

### Filtering

In both *Personal* and *All* views, you can open the filter menu and filter by:

* Source (interactive, API, CLI, Slack/Linear, scheduled)
* Day of creation
* Creator
* Status

This is the fastest way to isolate "everything that failed today," "runs from Slack," or "what a specific teammate triggered via integrations."