Integrations Overview

Warp integrations let your team trigger agents directly from the terminal, or from tools like Slack and 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

Note

For a full walkthrough of Warp’s integrations and configurable environments, please refer to Integration setup.

All of this is powered by the Oz 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.

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

Note

Learn more about slash commands and how to use them in the Slash Commands documentation.

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).
• 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.

Note

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, GitLab, or Bitbucket for step-by-step instructions.

3. Create an integration

Note

For easier setup, use the Oz web app at oz.warp.dev to configure integrations with a guided flow. The web app works on mobile devices.

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.