---
title: Installation
description: Install devv CLI on macOS or Linux in seconds.
---

# Installation

devv ships as a single static binary — no runtime dependencies required.

## macOS / Linux (recommended)

```bash
curl -fsSL https://devv.tools/install.sh | sh
```

This detects your OS and architecture automatically, downloads the correct binary, and installs to `/usr/local/bin`.

### Custom install directory

```bash
DEVV_INSTALL_DIR=~/.local/bin curl -fsSL https://devv.tools/install.sh | sh
```

## Homebrew

```bash
brew install devvtools/tap/devv
```

## From source

Requires [Bun](https://bun.sh) installed:

```bash
git clone https://github.com/bytangle-hq/devv.tools
cd devv.tools/packages/cli
bun install
bun build src/index.ts --compile --outfile devv
sudo mv devv /usr/local/bin/
```

## Verify installation

```bash
devv --version
# 0.1.0
```

## Supported platforms

| Platform | Architecture | Binary |
|----------|-------------|--------|
| macOS | Apple Silicon (arm64) | `devv-darwin-arm64` |
| macOS | Intel (x64) | `devv-darwin-x64` |
| Linux | x64 | `devv-linux-x64` |
| Linux | arm64 | `devv-linux-arm64` |

## Updating

Re-run the install script to update to the latest version:

```bash
curl -fsSL https://devv.tools/install.sh | sh
```

Or with Homebrew:

```bash
brew upgrade devv
```