> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Oz web app for cloud agents

Use the Oz web app to manage cloud agents, view runs, create schedules, and configure environments and integrations from any browser or mobile device.

The [Oz web app](https://oz.warp.dev) provides a visual interface for managing cloud agents. You can start runs, browse agents and skills, create schedules, configure environments, and set up integrations—all without installing Warp or using the CLI.

Note

The Oz web app works on mobile devices, so you can monitor and manage your cloud agents from anywhere.

Watch this short demo to create an environment and run an agent using the Oz web app:

![Oz web app cloud agents walkthrough](https://i.ytimg.com/vi/h9Wd77leIYg/sddefault.jpg)

## Quick reference

| Page | Path | What you can do |
| --- | --- | --- |
| **Runs** | `/runs` | View all runs, filter by status/source/creator, start new runs, inspect transcripts |
| **Agents** | `/agents` | Browse saved agents, create agents, configure defaults, and start runs |
| **Skills** | `/skills` | Browse skills from your environments, view suggested skills, create skills for agents, and start runs |
| **Schedules** | `/schedules` | Create scheduled agents, pause/enable schedules, view run history |
| **Environments** | `/environments` | Create and manage environments with repos, Docker images, and setup commands |
| **Secrets** | `/secrets` | Create and manage Warp-managed secrets for cloud agent runs |
| **Integrations** | `/integrations` | Connect Slack and Linear to trigger agents from external tools |

![The Oz web app's Runs page.](/_astro/oz-web-app-runs-view.Dc_nRcAU_Z2qfNGl.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

The Oz web app Runs page.

## When to use the web app

The Oz web app is ideal when you want to:

-   **Monitor agent activity** — View runs, check status, and inspect outputs from any device
-   **Start quick runs** — Dispatch agents without opening a terminal
-   **Manage agents and skills** — Create saved agents, browse skills from connected repositories, and start runs from either configuration
-   **Manage schedules visually** — Create and edit scheduled agents with a guided interface
-   **Configure environments** — Set up repos, Docker images, and setup commands through a form-based flow
-   **Set up integrations** — Connect Slack and Linear with a guided setup flow

For scripting, automation, and CI/CD workflows, use the [Oz CLI](/reference/cli/) or [API](/reference/api-and-sdk/).

## Getting started

When you first sign in to the Oz web app, you’ll see a guided onboarding flow that helps you get started based on your goals.

The onboarding asks “What brings you to Oz?” and offers three paths:

-   **Create an agent automation** — Walks you through setting up a scheduled agent, integration-triggered agent, or other automation
-   **Run Cloud Agents in Warp** — Opens the Warp app (or takes you to the download page) to run cloud agents interactively
-   **Build an app that uses agents** — Links to the [Oz Platform](/agent-platform/cloud-agents/platform/) docs for using the CLI, SDK, or API

You can skip onboarding at any time to go directly to the Runs page.

## Runs

The **Runs** page (`/runs`) is your central view for monitoring cloud agent activity. It shows runs across your account and team, where applicable, including those triggered from the CLI, API, integrations, and schedules.

### Run details

Each run displays the following information:

| Field | Description |
| --- | --- |
| **Status** | Working, succeeded, failed, canceled, errored, or blocked |
| **Title** | The run’s title or prompt summary |
| **Environment** | Which environment the agent ran in |
| **Creator** | Who started the run |
| **Source** | Where the run was triggered from (CLI, API, Slack, Linear, scheduled) |
| **Artifacts** | Any outputs like PRs or files created |
| **Credits** | How many credits the run consumed |

Click any run to open the detail pane, where you can view the full transcript, artifacts, and metadata.

### Filtering and search

| Quick filter | Shows |
| --- | --- |
| **All** | All runs |
| **Mine** | Only runs you created |
| **Active** | Runs currently in progress |
| **Failed** | Runs that failed |
| **Recurring** | Runs triggered by schedules |

You can also search by title, prompt, or agent name, and add advanced filters for source, status, creator, and date range.

### Starting a new run

To start a new run:

1.  Click **New run** in the header to start a cloud agent.
2.  Select an agent, if needed. Choose **Quick run** to run as yourself, or choose a saved agent from the **Agent** dropdown.
3.  Select the environment where the agent should run.
4.  Add a prompt with context and instructions for this specific run.

**Quick run** runs as your own user. A saved agent uses its saved defaults, and your prompt adds context for this particular execution.

### Inspecting orchestrated runs

The Oz web app renders [multi-agent orchestrations](/agent-platform/cloud-agents/orchestration/) as nested rows on the **Runs** page, so you can follow parent and child execution together.

Open a parent run from the Runs page. When the run has children, the detail pane adds a **Sub-agents** tab next to **Details**:

-   Each child agent row shows the child’s current status and title. Click a row to open that child’s detail pane; closing it returns you to the parent’s **Sub-agents** tab.
-   The parent’s own status badge at the top of the detail pane reflects the parent’s work, not its children. Open a child to inspect its state directly.

## Agents

The **Agents** page (`/agents`) is where you browse, create, and run saved agents. Agents are reusable cloud agent configurations that can include a prompt, skills, harness, model, environment, and secrets.

Skills are reusable instruction sets stored in repositories. You can attach existing skills to an agent through the **Skills** field; for more details, see [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/).

Saved agents use Warp’s team-scoped identity model, which lets a reusable agent own runs and carry default configuration for teammates. You manage saved agents from the Agents page. For plan limits, API endpoints, and API key binding behavior, see [Agents](/agent-platform/cloud-agents/agents/).

![The Agents page in the Oz web app.](/_astro/oz-web-app-agents.D_h_FuT__1J7kIn.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

The Agents page in the Oz web app.

Open an agent to review its prompt, skills, harness, model, environment, and attached secrets. From the detail pane, you can inspect activity, create schedules, edit configuration, or start a run from the saved agent.

### Running an agent

Click any agent to view its details, then click **New run** to start a run from that saved configuration. You can also click **New run** from the header to start a run with optional agent selection.

### Creating a new agent

To create a saved agent:

1.  Click **New agent** to open the guided creation flow.
2.  Define the instructions and defaults. Add a name, description, prompt, optional skills, harness, model, environment, and secrets.
3.  Click **Create agent**. The saved agent appears on the Agents page and is available for runs.

For deeper guidance on reusable skills and team-scoped identities, see [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) and [Agents](/agent-platform/cloud-agents/agents/).

![Creating a new agent in the Oz web app.](/_astro/oz-web-app-new-agent.BDCCUbrO_Z1b9cHq.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

Creating a new agent in the Oz web app.

## Skills

The **Skills** page (`/skills`) is where you browse and run skills. Skills are reusable instruction sets stored in repositories, and agents can include one or more skills as part of their default configuration.

Use the **From your Environments** filter to view skills from repositories connected to your environments, or switch to **Suggested** to view recommended skills. Open a skill to view its activity, schedules, and `SKILL.md` configuration.

### Running a skill

Click any skill to view its details, then click **New run** to start a run with that skill attached. You can also click **New run** from the page header to start a run with optional skill selection.

### Creating a skill for agents

To create a skill for agents:

1.  Click **New agent** on the Skills page to open the skill creation flow.
2.  Choose a repository from an existing environment with GitHub access.
3.  Define the skill. Add a skill name, description, and instructions.
4.  Click **Open Skill PR** to create a pull request that adds the skill to the selected repository.

![Creating a skill for agents in the Oz web app.](/_astro/oz-web-app-new-skill.Cqd5M8cR_pT4G3.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

Creating a skill in the Oz web app.

After the PR is merged, refresh skills so the new skill appears in the Oz web app.

## Schedules

The **Schedules** page (`/schedules`) lets you create and manage scheduled agents that run automatically on a cron schedule.

### Schedule details

Each schedule displays:

| Field | Description |
| --- | --- |
| **Name** | A descriptive name for the scheduled task |
| **Frequency** | Human-readable description of the cron schedule (e.g., “Every Monday at 10am”) |
| **Next run** | When the schedule will next execute |
| **Environment** | Which environment the scheduled agent runs in |
| **Agent** | Which saved agent the schedule uses (if any) |
| **Status** | Whether the schedule is active or paused |

![The Schedules page in the Oz web app.](/_astro/oz-web-app-schedules.CiPmn9eL_Z22FMSo.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

The Schedules page in the Oz web app.

### Creating a schedule

To create a scheduled agent:

1.  Click **New schedule** in the header.
2.  Name the schedule. Use a descriptive name that explains what the scheduled agent does.
3.  Set the frequency. Choose a preset or enter a cron schedule.
4.  Select the environment where the scheduled agent should run.
5.  Choose a saved agent, if needed.
6.  Add the prompt that the agent should follow each time it runs.
7.  Click **Create schedule**. The schedule appears on the Schedules page.

### Managing schedules

Click any schedule to view its details and recent run history. From the detail pane, you can:

-   **Edit** the schedule configuration
-   **Pause** or **enable** the schedule
-   **Delete** the schedule
-   **View past runs** triggered by this schedule

Note

For CLI-based schedule management, see [Scheduled Agents](/agent-platform/cloud-agents/triggers/scheduled-agents/).

## Environments

The **Environments** page (`/environments`) shows all environments configured for your account. Environments define the execution context for cloud agents, including repos, Docker images, and setup commands.

### Environment details

Each environment displays:

| Field | Description |
| --- | --- |
| **Name** | The environment’s identifier |
| **Docker image** | The container image used for execution |
| **Repositories** | Which repos the agent can access |
| **Setup commands** | Commands run before the agent starts |

![The Environments page in the Oz web app.](/_astro/oz-web-app-environments.AFeoom-N_1sy3qW.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

The Environments page in the Oz web app.

### Creating an environment

To create a new environment:

1.  Click **New environment** in the header.
2.  Name the environment. Use a descriptive name that explains the runtime context.
3.  Select the repositories the agent should be able to access.
4.  Choose a Docker image. Warp provides prebuilt dev images, or you can use your own.
5.  Add any setup commands that should run when the environment starts, such as `npm install`.
6.  Click **Create environment**. The environment appears on the Environments page.

Note

For advanced environment configuration, see [Environments](/agent-platform/cloud-agents/environments/) and the [CLI reference](/reference/cli/integration-setup/).

## Integrations

The **Integrations** page (`/integrations`) lets you configure first-party integrations with Slack and Linear.

### Available integrations

| Integration | Description |
| --- | --- |
| **Slack** | Tag @Oz in messages or threads to trigger agents directly from Slack conversations |
| **Linear** | Tag @Oz on issues to trigger agents from your issue tracker |

![The Integrations page in the Oz web app.](/_astro/oz-web-app-integrations.nS54nztb_Z2gl1ih.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

The Integrations page in the Oz web app.

### Setting up an integration

Click an integration to start the guided setup flow. You’ll authorize Warp to connect with the external service, select an environment, and configure any integration-specific settings.

Note

For detailed integration setup instructions, see [Slack](/agent-platform/cloud-agents/integrations/slack/) and [Linear](/agent-platform/cloud-agents/integrations/linear/).

## Related resources

-   [Cloud Agents overview](/agent-platform/cloud-agents/overview/) — Learn about cloud agents and when to use them
-   [Multi-agent orchestration](/agent-platform/cloud-agents/orchestration/) — Parent/child model and common orchestration patterns
-   [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) — Run agents based on reusable skill definitions
-   [Scheduled Agents](/agent-platform/cloud-agents/triggers/scheduled-agents/) — Run agents automatically on a cron schedule
-   [Environments](/agent-platform/cloud-agents/environments/) — Configure runtime context for cloud agents
-   [Managing Cloud Agents](/agent-platform/cloud-agents/managing-cloud-agents/) — Monitor agent activity and inspect runs
-   [Oz CLI](/reference/cli/) — Command-line interface for running agents
-   [Oz API & SDK](/reference/api-and-sdk/) — Programmatic access to cloud agents