🌐 unifly
Your UniFi Network, at Your Fingertips
✦ CLI + TUI for UniFi Network Controllers ✦
Features • Install • Quick Start • CLI • TUI • Architecture • Library • AI Agent Skill • Development
💜 What is unifly?
A complete command-line toolkit for managing Ubiquiti UniFi network controllers. One binary with 26 top-level commands for scripting and a built-in TUI dashboard for real-time monitoring, powered by a shared async engine that speaks every UniFi API dialect.
Manage devices, monitor clients, inspect VLANs, stream events, and watch bandwidth charts, all without leaving your terminal.
UniFi controllers expose multiple APIs with different capabilities. unifly unifies them all into a single, coherent interface so you never have to think about which endpoint to hit.
🤖 AI Agent? 👤 Human? Both Welcome.
unifly speaks fluent silicon and carbon.
Coding agents get a dedicated skill bundle: full CLI reference, automation workflows, and a ready-made network manager agent that can provision VLANs, audit firewalls, and diagnose connectivity without asking permission for every command. One command to install:
npx skills add hyperb1iss/uniflyHumans get a gorgeous 10-screen TUI, shell completions, pipe-friendly output, and the quiet satisfaction of never opening the UniFi web UI again. Keep scrolling to Install.
✦ Features
| Capability | What You Get |
|---|---|
| 🔮 Dual API Engine | Integration API (REST, API key) + Session API (session, cookie/CSRF) with automatic Hybrid negotiation |
| ⚡ Real-Time TUI | 10-screen dashboard with area-fill traffic charts, CPU/MEM gauges, live client counts, zoomable topology |
| 🦋 26 Top-Level Commands | Devices, clients, networks, WiFi, firewall policies, zones, ACLs, NAT, DNS, VPN, DPI, RADIUS, topology, raw API passthrough, tui... |
| 💎 Flexible Output | Table, JSON, compact JSON, YAML, and plain text. Pipe-friendly for scripting |
| 🔒 Secure Credentials | OS keyring storage for API keys and passwords, with plaintext config support when you choose it |
| 🌐 Multi-Profile | Named profiles for multiple controllers. Switch with a single flag |
| 🧠 Smart Config | Interactive wizard, environment variables, TOML config, CLI overrides |
| 📡 WebSocket Events | Live event streaming with 10K rolling buffer, severity filtering, pause/scroll-back |
| 📊 Historical Stats | WAN bandwidth area fills, client counts, DPI app/category breakdown (1h to 30d) |
| 🎨 SilkCircuit Theme | Neon-on-dark color palette powered by opaline. Token-based theming across CLI and TUI with ANSI fallback |
⚡ Install
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/unifly/main/install.sh | sh
Windows (PowerShell)
irm https://raw.githubusercontent.com/hyperb1iss/unifly/main/install.ps1 | iex
Other Methods
| Method | Command |
|---|---|
| Homebrew | brew install hyperb1iss/tap/unifly |
| AUR | yay -S unifly-bin |
| Cargo | cargo install --git https://github.com/hyperb1iss/unifly.git unifly |
| Binary | Download from GitHub Releases |
🔮 Quick Start
Run the interactive setup wizard:
unifly config init
The wizard walks you through controller URL, authentication method, and site selection. Credentials can be stored in your OS keyring or saved in plaintext config, depending on the option you choose.
Once configured: