hoppy @ractive

bunny bunny-net cdn cli dns edge rust storage

Use this command to install hoppy:

winget install --id=ractive.hoppy -e

Hoppy is a command-line tool for managing bunny.net cloud and edge services, including CDN pull zones, storage zones, DNS, video streaming, security (WAF/DDoS), edge scripting, and magic containers.

hoppy

A friendly CLI for bunny.net — CDN, storage, DNS, streaming, edge compute, magic containers, and libSQL — designed for humans and AI agents alike.

export BUNNY_API_KEY=your-api-key
hoppy pull-zone list

Many commands suggest a sensible next step on stderr (turn off with --no-hints), so you can drill in without leaving the terminal.

Install

Homebrew (macOS arm64, Linux x86_64/arm64 — Linux gets static musl binaries):

brew trust --formula ractive/tap/hoppy   # Homebrew 6+: third-party taps need one-time trust
brew install ractive/tap/hoppy

(Homebrew 6 introduced tap trust — formulae from third-party taps refuse to load until trusted; use brew trust ractive/tap to trust the whole tap instead.)

Debian / Ubuntu (apt) — from the hosted Cloudsmith repo:

curl -sLf 'https://dl.cloudsmith.io/public/ractive/hoppy/cfg/setup/bash.deb.sh' | sudo bash
sudo apt install hoppy

Fedora / RHEL / openSUSE (dnf/yum/zypper):

curl -sLf 'https://dl.cloudsmith.io/public/ractive/hoppy/cfg/setup/bash.rpm.sh' | sudo bash
sudo dnf install hoppy   # or: yum install hoppy / zypper install hoppy

Windows (Scoop):

scoop bucket add ractive https://github.com/ractive/scoop-bucket
scoop install hoppy

Anywhere with Rust (Cargo):

cargo install hoppy-cli   # binary is `hoppy`

The apt/dnf packages and the .deb/.rpm files also install shell completions and man pages system-wide. Standalone .deb/.rpm files and prebuilt archives for every target — including static musl Linux builds, each bundling the binary, shell completions, and man pages — are on the releases page. Windows/winget support is not available yet.

Shell completions

The packaged installs wire completions up for you. For a manual setup (e.g. the cargo install route), generate them with:

hoppy completions bash &gt; ~/.local/share/bash-completion/completions/hoppy
hoppy completions zsh  &gt; "${fpath[1]}/_hoppy"
hoppy completions fish &gt; ~/.config/fish/completions/hoppy.fish

Verifying downloads

Release archives for native targets ship CycloneDX SBOMs and GitHub build-provenance attestations. Verify an archive with the GitHub CLI:

gh attestation verify hoppy-v0.5.0-aarch64-apple-darwin.tar.gz --owner ractive

Quick start

export BUNNY_API_KEY=your-api-key

hoppy auth check
hoppy pull-zone list
hoppy pull-zone create --name my-zone --origin-url https://origin.example.com
hoppy stream library list
hoppy container app list

Where to go next

docs/MANUAL.md — examples for every service area, global flags, env vars, testing setup.
hoppy-knowledgebase/cli/command-tree.md — the full subcommand tree at a glance.
hoppy --help — authoritative per-flag help.
dash.bunny.net — bunny.net concept docs.

AI-generated project

This project is largely AI-generated ("vibe coded"). See LICENSE for details on copyright and usage. Users are responsible for ensuring compliance with any third-party rights that may apply.

Package repository hosting

Package repository hosting is graciously provided by Cloudsmith. Cloudsmith is the only fully hosted, cloud-native, universal package management solution, that enables your organization to create, store and share packages in any format, to any place, with total confidence.

License

MIT