### Development Commands - Setup

Source: https://docs.warp.dev/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind

Commands to install dependencies and start the development server.

```bash
# Install dependencies
npm install

# Set up environment (Firebase config is public but consider security)
# No additional env setup needed for development

# Development server
npm run dev
```

--------------------------------

### Example setup commands

Source: https://docs.warp.dev/agent-platform/cloud-agents/environments

Examples illustrating safer, repeatable setup patterns versus less safe, potentially drifting patterns.

```bash
# Safer patterns (repeatable and stable)
mkdir -p .cachenpm ci
# Less safe patterns (can fail on rerun or drift over time)
mkdir .cachenpm install
```

--------------------------------

### Create environment with guided setup using GitHub URLs

Source: https://docs.warp.dev/agent-platform/cloud-agents/environments

Example of using the /create-environment command with GitHub URLs.

```bash
# GitHub URLs/create-environmenthttps://github.com/warpdotdev/warp-internal.git
```

--------------------------------

### Create your first run

Source: https://docs.warp.dev/reference/api-and-sdk/quickstart

Submit a prompt to start an agent run.

```bash
curl -X POST https://app.warp.dev/api/v1/agent/run \
  -H "Authorization: Bearer $WARP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{    "prompt": "Scan the repo for outdated dependencies and summarize the findings.",    "config": {      "environment_id": "<ENV_ID>"    }  }'
```

--------------------------------

### Create environment with guided setup using local file paths

Source: https://docs.warp.dev/agent-platform/cloud-agents/environments

Example of using the /create-environment command with local file paths for repository inspection.

```bash
# Local file paths/create-environment ./warp-internal ./warp-server
/create-environment warpdotdev/warp-internal warpdotdev/warp-server
```

--------------------------------

### Example response

Source: https://docs.warp.dev/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed

An example of an error response when the environment setup fails.

```json
{
  "type": "/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed/",
  "title": "Failed to clone repository: branch 'main' not found in acme/backend",
  "status": 500,
  "instance": "/api/v1/agent/tasks",
  "error": "Failed to clone repository: branch 'main' not found in acme/backend",
  "retryable": false
}
```

--------------------------------

### Install Warp on x64 Linux

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Download and make the AppImage executable for x64 systems.

```bash
curl -L "https://app.warp.dev/download?package=appimage" -o Warp-x64.AppImage
chmod +x Warp-x64.AppImage
```

--------------------------------

### Run a command

Source: https://docs.warp.dev/quickstart

Example of running a command in Warp.

```shell
ls -la
```

--------------------------------

### Install Warp on Linux (Debian/Ubuntu)

Source: https://docs.warp.dev/quickstart

Install Warp on Debian/Ubuntu systems.

```shell
sudo apt install ./warp-terminal.deb
```

--------------------------------

### Install Warp on Windows using WinGet

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on Windows using the WinGet package manager.

```bash
winget install Warp.Warp
```

--------------------------------

### Example Commands

Source: https://docs.warp.dev/terminal/sessions/launch-configurations

A launch configuration where the first window executes two commands on start, and the second window has a split pane that executes a command on start.

```yaml
---
name: Example Commands
windows:
  - tabs:
      - title: Documents
        layout:
          cwd: /Users/warp-user/Documents
          commands:
            - exec: ls
            - exec: code .
        color: blue
  - tabs:
      - title: Downloads
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Downloads
              commands:
                - exec: curl http://example.com -o my.file
                - exec: cp my.file my.file2
            - cwd: /Users/warp-user
              commands:
                - exec: ssh user@remote.server.com
        color: green

```

--------------------------------

### Install Warp on ARM64 Linux

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Download and make the AppImage executable for ARM64 systems.

```bash
curl -L "https://app.warp.dev/download?package=appimage_arm64" -o Warp-ARM64.AppImage
chmod +x Warp-ARM64.AppImage
```

--------------------------------

### Install Warp on Linux

Source: https://docs.warp.dev/enterprise/getting-started/getting-started-developers

Instructions for installing Warp on Debian/Ubuntu, Fedora/RHEL, or using the install script.

```bash
# Debian/Ubuntusudo dpkg -i warp-terminal_*.deb
# Fedora/RHELsudo rpm -i warp-terminal-*.rpm
# Or use the install scriptcurl -fsSL https://www.warp.dev/install.sh | bash
```

--------------------------------

### Video Embed Component

Source: https://docs.warp.dev/

Example of importing a VideoEmbed component from '@components/VideoEmbed.astro'.

```javascript
import VideoEmbed from '@components/VideoEmbed.astro';
```

--------------------------------

### Start OpenCode session

Source: https://docs.warp.dev/guides/external-tools/how-to-set-up-opencode

Navigate to your project directory and launch OpenCode.

```bash
cd ~/your-project
opencode
```

--------------------------------

### Build Warp from source

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Clone the Warp repository, bootstrap dependencies, and run a development build.

```bash
git clone https://github.com/warpdotdev/warp.git
cd warp
./script/bootstrap
cargo run
```

--------------------------------

### Run a cloud agent

Source: https://docs.warp.dev/enterprise/getting-started/quickstart

Once your environment is ready, use the following command to launch a cloud agent (use the environment ID from above):

```bash
oz agent run-cloud --env my-env --prompt "Review the open PRs in this repo"
```

--------------------------------

### Install Warp on OpenSUSE/SLE using .rpm package

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on OpenSUSE and SLE-based distributions by downloading and installing an .rpm package.

```bash
sudo zypper install ./<file>.rpm
```

--------------------------------

### Run your first agent locally

Source: https://docs.warp.dev/enterprise/getting-started/quickstart

Start a conversation right in the terminal. Try the following prompt:

```bash
Explain the architecture of this project
```

--------------------------------

### Install Warp on Debian/Ubuntu using .deb package

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on Debian-based and Ubuntu-based distributions by downloading and installing a .deb package.

```bash
sudo apt install ./<file>.deb
```

--------------------------------

### Run the /cloud-agent command

Source: https://docs.warp.dev/agent-platform/cloud-agents/quickstart

This command launches a new cloud agent. It checks if you have an environment set up, and if not, it guides you through creating one.

```bash
/cloud-agent
```

--------------------------------

### Run a local agent

Source: https://docs.warp.dev/reference/cli/quickstart

From any directory, run: This uses the default agent profile, loads any available MCP servers, and executes the run locally. The output appears directly in your terminal.

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

--------------------------------

### Create environment using file paths or GitHub URLs

Source: https://docs.warp.dev/reference/cli/integration-setup

Examples of using the /create-environment slash command with different arguments.

```bash
# File paths/create-environment ./warp-internal ./warp-server
/create-environment warpdotdev/warp-internal warpdotdev/warp-server
# GitHub URLs/create-environment https://github.com/warpdotdev/warp-internal.git
```

--------------------------------

### Install Warp on macOS using Homebrew

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on macOS using the Homebrew package manager.

```bash
brew install --cask warp
```

--------------------------------

### Install Warp on Arch Linux using .pkg.tar.zst package

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on Arch Linux-based distributions by downloading and installing a .pkg.tar.zst package.

```bash
sudo pacman -U ./<file>.pkg.tar.zst
```

--------------------------------

### Example prompt for OpenCode

Source: https://docs.warp.dev/guides/external-tools/how-to-set-up-opencode

Provide a natural language prompt to OpenCode for tasks like explaining architecture or adding code.

```bash
Explain the architecture of this project
```

```bash
Add input validation to the user registration endpoint
```

--------------------------------

### Install Warp on RHEL/Fedora/CentOS using .rpm package

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Installs Warp on RHEL, Fedora, and CentOS-based distributions by downloading and installing an .rpm package.

```bash
sudo dnf install ./<file>.rpm
```

--------------------------------

### List all recent runs

Source: https://docs.warp.dev/reference/api-and-sdk/quickstart

To list all recent runs:

```bash
curl "https://app.warp.dev/api/v1/agent/runs" \
  -H "Authorization: Bearer $WARP_API_KEY"
```

--------------------------------

### Start the worker

Source: https://docs.warp.dev/agent-platform/cloud-agents/self-hosting/quickstart

Run the oz-agent-worker container, mounting the host’s Docker socket so the worker can spawn task containers. Choose any --worker-id meaningful for your team — you’ll use this value to route tasks to this worker.

```bash
docker run -v /var/run/docker.sock:/var/run/docker.sock \
  -e WARP_API_KEY="$WARP_API_KEY" \
  warpdotdev/oz-agent-worker --worker-id "my-worker"
```

--------------------------------

### Run a cloud agent

Source: https://docs.warp.dev/agent-platform/cloud-agents/self-hosting/quickstart

Command to run a cloud agent, used for troubleshooting host and worker ID mismatches.

```bash
oz agent run-cloud --host <your_host_id> --worker-id <your_worker_id>
```

--------------------------------

### Verify Docker is running

Source: https://docs.warp.dev/agent-platform/cloud-agents/self-hosting/quickstart

Check if the Docker daemon is running and its platform compatibility.

```bash
docker info
```

--------------------------------

### Multi-line editing example

Source: https://docs.warp.dev/quickstart

Example of multi-line editing in Warp's input editor.

```shell
echo "line 1"
Shift+Enter
echo "line 2"
Shift+Enter
echo "line 3"
Enter
```

--------------------------------

### Manual Yum Repository Configuration and Installation

Source: https://docs.warp.dev/getting-started/quickstart/installation-and-setup

Commands to manually configure the Warp yum repository and install Warp using rpm and zypper.

```bash
sudo rpm --import https://releases.warp.dev/linux/keys/warp.ascsudo sh -c 'echo -e "[warpdotdev]\nname=warpdotdev\ntype=rpm-md\nbaseurl=https://releases.warp.dev/linux/rpm/stable\nenabled=1\nautorefresh=1\ngpgcheck=1\ngpgkey=https://releases.warp.dev/linux/keys/warp.asc\nkeeppackages=0" > /etc/zypp/repos.d/warpdotdev.repo'sudo zypper install warp-terminal
```