> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/warpdotdev/warp/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started with Warp

> Download Warp, log in, run your first terminal command, open Agent Mode, and dispatch a cloud agent with the oz CLI — all in one guide.

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.

<Steps>
  <Step title="Download and install Warp">
    Go to [warp.dev/download](https://www.warp.dev/download) and grab the installer for your platform.

    <Tabs>
      <Tab title="macOS">
        Open the downloaded `.dmg`, drag **Warp** into your **Applications** folder, and launch it from Spotlight or Finder.

        You can also install with Homebrew:

        ```bash theme={null}
        brew install --cask warp
        ```
      </Tab>

      <Tab title="Linux">
        Download the `.deb` or `.rpm` package for your distribution from [warp.dev/download](https://www.warp.dev/download). Both x86\_64 and arm64 builds are available.

        ```bash theme={null}
        # Debian / Ubuntu (.deb)
        sudo dpkg -i warp-terminal_*.deb

        # Fedora / RHEL (.rpm)
        sudo rpm -i warp-terminal_*.rpm
        ```
      </Tab>

      <Tab title="Windows">
        Run the downloaded `.exe` installer and follow the setup wizard. Warp will launch automatically when installation completes.
      </Tab>
    </Tabs>
  </Step>

  <Step title="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](https://www.warp.dev).

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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:

    ```bash theme={null}
    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.
  </Step>

  <Step title="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:

    <Prompt description="List files and summarize the current directory" actions={["copy"]}>
      List the files in the current directory and give me a one-sentence description of what this project does based on the README.
    </Prompt>

    Agent Mode will read your shell environment, run commands as needed, and show you each step it takes before making any changes.

    <Tip>
      Use Agent Mode rules and Skills to customize how the agent behaves in your repository. See the [Agent Mode docs](/agent/agent-mode) for details.
    </Tip>
  </Step>

  <Step title="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:

    ```bash theme={null}
    # 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](/cloud/overview) and [CLI reference](/cli/overview) for the full `oz` command set.
  </Step>
</Steps>

## What to explore next

<CardGroup cols={2}>
  <Card title="Agent Mode" icon="robot" href="/agent/agent-mode">
    Learn how to configure prompts, rules, and Skills to get the most out of Warp's built-in AI agent.
  </Card>

  <Card title="Terminal blocks" icon="terminal" href="/terminal/blocks">
    Understand how Blocks work and how to use them to navigate, share, and reference command output.
  </Card>

  <Card title="MCP servers" icon="plug" href="/agent/mcp-servers">
    Extend Agent Mode with tools from any Model Context Protocol server.
  </Card>

  <Card title="Cloud Agents (Oz)" icon="cloud" href="/cloud/overview">
    Run agents headlessly in the cloud, schedule them on a cron, and manage secrets.
  </Card>
</CardGroup>