Installation

Install Rune in seconds. No dependencies required.

---

Philosophy

Installing Rune should feel similar to installing Git.

Rune should not require:

• Python
• Node.js
• Java
• Docker
• Cargo
• Homebrew

The primary installation method is a single command.

---

Linux and macOS

Install the latest release:

curl -fsSL https://raw.githubusercontent.com/rune-context/rune/main/install.sh | sh

Verify installation:

rune --version

Example:

Rune 0.1.0

---

Windows

PowerShell:

irm https://raw.githubusercontent.com/rune-context/rune/main/install.ps1 | iex

Verify:

rune --version

---

Supported Platforms

Linux

Architectures:

• amd64
• arm64

---

macOS

Architectures:

• amd64
• arm64

---

Windows

Architectures:

• amd64
• arm64

---

Release Artifacts

Each GitHub release provides:

rune-linux-amd64.tar.gz
rune-linux-arm64.tar.gz

rune-darwin-amd64.tar.gz
rune-darwin-arm64.tar.gz

rune-windows-amd64.zip
rune-windows-arm64.zip

The installer automatically downloads the correct package.

---

Installing From Source

Requirements:

• Go 1.24+

Clone the repository:

git clone https://github.com/rune-context/rune.git

Build:

go build -o rune ./cmd/rune

Run:

./rune --version

---

Installation Locations

Linux

Preferred:

/usr/local/bin

Fallback:

$HOME/.local/bin

---

macOS

Preferred:

/usr/local/bin

Apple Silicon:

/opt/homebrew/bin

Fallback:

$HOME/.local/bin

---

Windows

Preferred:

%USERPROFILE%\bin

---

Upgrading

Upgrade to the latest version:

rune self-update

or simply rerun:

curl -fsSL https://raw.githubusercontent.com/rune-context/rune/main/install.sh | sh

Existing repositories and .rune/ directories remain untouched.

---

Uninstall

Linux/macOS:

rm $(which rune)

Windows:

Delete:

%USERPROFILE%\bin\rune.exe

No registry cleanup is required.

---

Zero Runtime Dependencies

Rune ships as a single standalone executable.

After installation, no additional runtime is required.

Rune does not depend on:

• Python
• Node.js
• Java
• Docker

---

Package Managers

Package managers are optional conveniences.

Future support may include:

Homebrew

brew install rune

Winget

winget install rune

Scoop

scoop install rune

Apt

apt install rune

Pacman

pacman -S rune

Chocolatey

choco install rune

However, the canonical installation method remains:

curl -fsSL https://raw.githubusercontent.com/rune-context/rune/main/install.sh | sh

---

Installation Philosophy

Installation should take less than ten seconds.

Developers should be able to go from:

curl -fsSL ... | sh

to:

rune init
rune index
rune context "Add Google OAuth"

without installing anything else.

---

See Also

• Getting Started
• Commands
• Repository Format
• Plugin System

---

Git stores history.

Rune stores understanding.