Installation

Choose the installation method that works best for your system.

Quick Install (Recommended)

The fastest way to install rung on macOS or Linux:

curl -sSf https://rungstack.com/install.sh | sh

This script automatically detects your platform and installs the latest version.

Options

Custom install directory (defaults to /usr/local/bin or ~/.local/bin):

INSTALL_DIR=~/bin curl -sSf https://rungstack.com/install.sh | sh

Windows

Download the .zip from releases and add to your PATH.

Homebrew (macOS/Linux)

brew tap auswm85/rung https://github.com/auswm85/rung
brew install rung

From crates.io

If you have Rust installed:

cargo install rung-cli

With cargo-binstall

Faster installation without compilation:

cargo binstall rung-cli

From Source

Clone and build from the repository:

git clone https://github.com/auswm85/rung
cd rung
cargo install --path crates/rung-cli

Verify Installation

After installation, verify rung is available:

rung --version

You should see output like:

rung 0.1.0

Requirements

• Git 2.x — rung uses git2-rs for git operations
• GitHub CLI (gh) authenticated, or GITHUB_TOKEN environment variable

Setting up GitHub Authentication

rung needs GitHub access to create and manage pull requests. You have two options:

Option 1: GitHub CLI (Recommended)

Install and authenticate the GitHub CLI:

# Install gh (if not already installed)
brew install gh        # macOS
apt install gh         # Ubuntu/Debian
winget install gh      # Windows

# Authenticate
gh auth login

Option 2: Personal Access Token

Set the GITHUB_TOKEN environment variable:

export GITHUB_TOKEN=ghp_your_token_here

Your token needs these scopes:

• repo — Full control of private repositories
• read:org — Read org membership (if using organization repos)

Next Steps

Once installed, head to the Quick Start guide to create your first stack.