Warp Terminal & Oz

Appearance

SOP 001: Installation & Setup ​

Fresh
FieldValue
SOP IDSOP-001
Version1.0
StatusActive
Sourcedocs.warp.dev

Overview ​

Install Warp Terminal, the Oz CLI, and authenticate to start using AI agents.

Prerequisites ​

  • macOS 12+, Windows 10+, or Linux (Ubuntu 22.04+, Fedora 38+, Arch)
  • Internet connection for authentication
  • 500MB disk space

Procedure ​

Step 1: Install Warp Terminal ​

bash
brew install --cask warp
bash
# Download from https://www.warp.dev/
# Open the .dmg and drag Warp to Applications
bash
winget install Warp.Warp
bash
# Add Warp repository (see docs.warp.dev for latest instructions)
sudo apt install warp-terminal
bash
sudo yum install warp-terminal

Step 2: Install the Oz CLI ​

The CLI is bundled with Warp. To make it globally accessible:

macOS:

  1. Open Warp
  2. Open Command Palette: CMD+P
  3. Search for and select "Install Oz CLI Command"
  4. Enter admin password if prompted

Windows:

  • During installation, select "Add Warp to PATH"
  • Or manually add the Warp installation directory to your system PATH

Standalone CLI (without Warp app):

bash
brew tap warpdotdev/warp
brew update
brew install --cask oz
bash
sudo apt install oz-stable

Step 3: Verify Installation ​

bash
oz --version

WARNING

If oz is not found, ensure it's in your PATH. On macOS, the CLI installs to /usr/local/bin.

Step 4: Authenticate ​

Interactive login (recommended for local machines):

bash
oz login

This prints a sign-in URL. Open it in your browser to complete authentication.

API key authentication (for CI/CD, headless servers):

bash
export WARP_API_KEY="wk-xxx..."
oz agent run --prompt "hello"

INFO

If you're already signed into the Warp desktop app, the CLI automatically reuses your credentials.

Step 5: Test Your Setup ​

bash
oz agent run --prompt "list the files in this directory and describe what they do"

Verification Checklist ​

  • [ ] Warp Terminal launches successfully
  • [ ] oz --version returns a version number
  • [ ] oz login completes without errors
  • [ ] oz agent run --prompt "hello" produces a response

Troubleshooting ​

IssueSolution
oz: command not foundRe-run CLI installation or add to PATH manually
Browser doesn't open for loginCopy the URL from terminal and paste in browser
Authentication timeoutCheck internet connection, try oz login again
Permission denied on macOSRun CLI installation with admin privileges

See Also ​