Skip to main content
Warp is an agentic development environment built on top of the terminal. This guide walks you through installing Warp, signing in, running a command, using Agent Mode for the first time, and dispatching a cloud agent with the oz CLI.
1

Download and install Warp

Go to warp.dev/download and grab the installer for your platform.
Open the downloaded .dmg, drag Warp into your Applications folder, and launch it from Spotlight or Finder.You can also install with Homebrew:
brew install --cask warp
2

Log in to your Warp account

When Warp opens for the first time it will prompt you to sign in. Log in with your existing Warp account, or create a free account at warp.dev.
A Warp account is required to use Agent Mode and cloud features. The terminal itself works without an account after sign-in is dismissed, but AI features will not be available.
3

Run your first command

Warp works like any terminal, but every command you run becomes a structured Block — the input you typed, the output it produced, and metadata like exit code are all grouped together and selectable.Try running a command to confirm your environment:
echo "Hello from Warp 👋" && uname -sr
The output appears in a block beneath your input. You can click any block to select it, copy its output, or share it with a teammate.
4

Open Agent Mode and run your first prompt

Agent Mode is Warp’s built-in AI coding agent. It can read your codebase, write and edit files, and run shell commands iteratively toward a goal.To open Agent Mode:
  1. Press Ctrl+I (or Cmd+I on macOS) in any Warp session, or click the Agent button in the toolbar.
  2. Type a natural-language prompt and press Enter.
For example, ask it to scaffold a project:

List files and summarize the current directory

Agent Mode will read your shell environment, run commands as needed, and show you each step it takes before making any changes.
Use Agent Mode rules and Skills to customize how the agent behaves in your repository. See the Agent Mode docs for details.
5

Run a cloud agent with oz

The oz CLI (bundled with Warp) lets you dispatch AI agents to run in isolated cloud environments — no local terminal required. This is useful for long-running tasks, scheduled automation, and CI pipelines.Log in and run your first cloud agent:
# Log in to your Warp account from the CLI
oz login

# Run an agent task locally
oz agent run --prompt "Add a changelog entry for the latest commit in this repo"
The agent runs and streams its output back to your terminal. Use oz agent run-cloud to dispatch a headless run to Warp’s cloud infrastructure instead. See the Cloud Agents overview and CLI reference for the full oz command set.

​
What to explore next

Agent Mode

Learn how to configure prompts, rules, and Skills to get the most out of Warp’s built-in AI agent.

Terminal blocks

Understand how Blocks work and how to use them to navigate, share, and reference command output.

MCP servers

Extend Agent Mode with tools from any Model Context Protocol server.

Cloud Agents (Oz)

Run agents headlessly in the cloud, schedule them on a cron, and manage secrets.

Build docs developers (and LLMs) love

Get started for freeTalk to us