# Integrations

Warp integrations let your team trigger agents directly from the terminal, or from tools like [Slack](https://docs.warp.dev/agent-platform/cloud-agents/integrations/slack) and [Linear](https://docs.warp.dev/agent-platform/cloud-agents/integrations/linear). Once set up, agents can:

* Read conversation or issue context
* Run code inside your codebase in a remote environment
* Open pull requests and perform other multi-step agent workflows on your behalf

{% hint style="info" %}
For a full walkthrough of Warp's integrations and configurable environments, please refer to [Integration setup](https://docs.warp.dev/reference/cli/integration-setup).
{% endhint %}

All of this is powered by the [Oz CLI](https://docs.warp.dev/reference/cli).

***

## Quickstart

The fastest way to get agents running from Slack or Linear is to create an environment with the guided flow. An **environment** defines everything the agent needs to run your code remotely, including your Docker image, repos, and setup commands.

{% embed url="<https://www.youtube.com/watch?v=ahFfInVD0HQ>" %}

#### 1. Run /create-environment

From Warp, run the following slash command:

```
/create-environment
```

You can run it inside any repo, or point it at multiple repos:

```
/create-environment ./frontend ./backend
/create-environment your-org/repo-name
/create-environment https://github.com/your-org/api.git
```

{% hint style="info" %}
Learn more about slash commands and how to use them in the [Slash Commands](https://docs.warp.dev/agent-platform/warp-agents/capabilities-overview/slash-commands) documentation.
{% endhint %}

The guided flow will:

* Detect which repos you want the agent to work with
* Identify languages, frameworks, and tools
* Suggest a Docker image (or build/push one if needed)
  * The Docker image can be your own custom image, an official base image (e.g. node, python), or one of Warp's prebuilt dev images (see [repo](https://github.com/warpdotdev/oz-dev-environments)).
* Recommend setup commands
* Create the environment and return an environment ID

This produces a ready-to-use environment that Warp can use across Slack, Linear, and terminal triggers.

#### 2. Authorize GitHub

Warp will prompt you to install or update the Warp GitHub app so the agent can read and write to the repos you included. You only need to do this once. Teammates will authorize on their first run as needed.

{% hint style="info" %}
**Using Azure DevOps, GitLab, or Bitbucket?** Native integrations for these platforms are not yet available, but you can connect repositories by storing a personal access token as a Warp-managed secret and cloning via a setup command. See [Azure DevOps](https://docs.warp.dev/agent-platform/cloud-agents/integrations/azure-devops), [GitLab](https://docs.warp.dev/agent-platform/cloud-agents/integrations/gitlab), or [Bitbucket](https://docs.warp.dev/agent-platform/cloud-agents/integrations/bitbucket) for step-by-step instructions.
{% endhint %}

#### 3. Create an integration

{% hint style="info" %}
For easier setup, use the [Oz web app](https://docs.warp.dev/agent-platform/cloud-agents/oz-web-app) at [oz.warp.dev](https://oz.warp.dev) to configure integrations with a guided flow. The web app works on mobile devices.
{% endhint %}

Alternatively, use the CLI:

For Slack:

```
oz integration create slack --environment <ENV_ID>
```

For Linear:

```
oz integration create linear --environment <ENV_ID>
```

The CLI opens an authorization page where you install Oz into your Slack workspace or Linear team.

#### 4. Start using agents

In Slack:

* Tag **@Oz** in a message or thread
* Or DM the bot

In Linear:

* Tag @Oz on an issue

Warp will read the thread/issue, spin up your environment, run the workflow in the cloud, and post progress + PRs back into the same conversation.

***

For more details on configuring integrations and environments in Warp, please refer to [Integration setup](https://docs.warp.dev/reference/cli/integration-setup).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.warp.dev/agent-platform/cloud-agents/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.