---
title: Installation
description: Install rippy with Homebrew, cargo, cargo-binstall, or from GitHub Releases.
---
rippy ships as a single static binary. Pick whichever installer you prefer —
all four produce the same `rippy` executable.
## Homebrew (macOS and Linux)
```sh
brew install mpecan/tools/rippy
```
This installs the latest release from the
[`mpecan/tools`](https://github.com/mpecan/homebrew-tools) tap.
## Cargo (build from source)
```sh
cargo install rippy-cli
```
The crate name is `rippy-cli`; the binary it installs is called `rippy`.
Requires a recent stable Rust toolchain (edition 2024, Rust 1.93+).
## cargo-binstall (prebuilt binaries)
```sh
cargo binstall rippy-cli
```
Downloads the prebuilt binary for your platform instead of compiling from
source. Faster than `cargo install`, no Rust toolchain needed.
## GitHub Releases (manual download)
Prebuilt binaries are attached to each
[GitHub release](https://github.com/mpecan/rippy/releases) for:
- macOS Apple Silicon (`aarch64-apple-darwin`)
- macOS Intel (`x86_64-apple-darwin`)
- Linux x86_64 (`x86_64-unknown-linux-gnu`)
- Linux aarch64 (`aarch64-unknown-linux-gnu`)
Extract the `.tar.gz`, drop `rippy` on your `PATH`, and you are done.
## Verify the install
```sh
rippy --version
```
If that prints a version number, you are ready to set up a config.
## Next: pick a package
The fastest way to get a working config is to let rippy pick one for you:
```sh
rippy init
```
This walks you through picking a [safety package](/getting-started/packages/)
(`review`, `develop`, or `autopilot`) and writes the resulting config to
`~/.rippy/config.toml`. You can edit or override it at any time.
Then wire rippy into your AI tool of choice —
[Claude Code](/getting-started/claude-code/),
[Cursor](/getting-started/cursor/),
[Gemini CLI](/getting-started/gemini-cli/), or
[Codex CLI](/getting-started/codex/).