Skip to content

Quick Start

Fresh

Source

Based on Warp Official Documentation - Last updated February 2026

Get Warp installed and run your first agent in under 5 minutes.

What is Warp?

Warp is an Agentic Development Environment - a modern terminal combined with powerful AI agents that help you build, test, deploy, and debug code. Warp's AI is powered by Oz, the orchestration platform for cloud agents.

Step 1: Install Warp

PlatformCommand
macOSDownload from warp.dev or brew install --cask warp
Windowswinget install Warp.Warp
Linuxsudo apt install warp-terminal (or yum/pacman)

Step 2: Install the Oz CLI

The Oz CLI comes bundled with Warp. To make it globally available:

macOS: Open Command Palette (CMD+P) and select "Install Oz CLI Command"

Windows: During installation, select "Add Warp to PATH"

Standalone (macOS):

bash
brew tap warpdotdev/warp
brew install --cask oz

Step 3: Authenticate

bash
oz login

This opens a browser-based sign-in flow. Your credentials are stored securely for future CLI use.

Step 4: Run Your First Agent

bash
oz agent run --prompt "summarize this directory"

The agent will:

  1. Start a new cloud agent session
  2. Access your current working directory
  3. Autonomously execute commands and stream output

Step 5: Add GitHub Context (Optional)

bash
oz mcp add github
oz agent run --prompt "Open a pull request that fixes TODOs in this repo"

Next Steps