Installation
Install unifly via Homebrew, Cargo, AUR, or binary download
πQuick Install
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/unifly/main/install.sh | sh
# Windows
irm https://raw.githubusercontent.com/hyperb1iss/unifly/main/install.ps1 | iex
The installer detects your platform, downloads the latest release binary, adds it to your PATH, and installs the agent skill for your user. Set UNIFLY_NO_SKILL=1 to skip the skill.
πPackage Managers
# Homebrew
brew install hyperb1iss/tap/unifly
# AUR (Arch)
yay -S unifly-bin
# Cargo
cargo install unifly
πFrom Source
Requires Rust 1.94+ (edition 2024):
git clone https://github.com/hyperb1iss/unifly.git
cd unifly
cargo build --workspace --release
# Binary at target/release/unifly
Or install directly from git:
cargo install --git https://github.com/hyperb1iss/unifly.git unifly
πShell Completions
# Bash
unifly completions bash > ~/.local/share/bash-completion/completions/unifly
# Zsh
unifly completions zsh > ~/.zfunc/_unifly
# Fish
unifly completions fish > ~/.config/fish/completions/unifly.fish
# PowerShell
unifly completions powershell | Out-String | Invoke-Expression
πAgent Skill
Coding agents find unifly through a small discovery skill. Package managers install unifly for every user and cannot write into your home directory, so after Homebrew, AUR, Cargo, or a manual download, add it yourself:
unifly skill --install
It lands in ~/.agents/skills/unifly/SKILL.md. See AI Agent Skill for Claude Code and other directories.
πVerify
unifly --version
πNext Steps
Youβre in! Now configure your first controller profile:
- Quick Start: run
unifly config initand explore your network - Authentication: choose the right auth mode
- Troubleshooting: if something goes wrong