⌨️ eeroctl

Manage your Eero mesh Wi-Fi from the terminal

A powerful command-line interface for Eero mesh network management.
Intuitive commands, multiple output formats, and shell completion.

Get Started · Documentation · Install · License

⚡ Features

🧭 Intuitive commands — noun-first structure (eero network list)
📊 Multiple formats — table, list, JSON, YAML, text
🛡️ Safety rails — Y/N prompts for disruptive writes, a typed REBOOT phrase for anything that restarts the mesh, and an explicit note on writes the SDK has not verified
🔧 Script-friendly — non-interactive mode, fixed exit codes, EEROCTL_* environment variables, EEROCTL_SESSION_TOKEN for CI
🐚 Shell completion — bash, zsh, fish

Upgrading from 2.x? 3.0.0 changes exit codes, auth status output, environment-variable names and credential storage. See the Migration guide.

📦 Install

Homebrew

brew install fulviofreitas/eeroctl/eeroctl

PyPI

pip install eeroctl

From source

git clone https://github.com/fulviofreitas/eeroctl.git
cd eeroctl
uv sync && source .venv/bin/activate

Or with pip:

python3 -m venv .venv && source .venv/bin/activate
pip install -e .

🚀 Quick Start

eero auth login           # Authenticate
eero network list         # List networks
eero device list          # Connected devices
eero eero list            # Mesh nodes
eero network speedtest run && sleep 60 && eero network speedtest show

Tip: Both eero and eeroctl commands are available and work identically.

📖 Documentation

Full documentation lives in the Wiki:

📚 Guide	Description
CLI Reference	Commands, flags & exit codes
Usage Examples	Practical examples
Configuration	Auth storage & env vars
Troubleshooting	Common issues
Migration	Upgrading to 3.0.0

🔗 Dependencies

Requires eero-api 8.0.3 (pinned exactly) and Python 3.12+.

📄 License

MIT — see LICENSE

📊 Repository Metrics

Repository Metrics

Metadata

Release files for eeroctl 3.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eeroctl 3.4.1
File	Size	Uploaded
eeroctl-3.4.1.tar.gz	170.9 kB	Oct 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for eeroctl 3.4.1
File	Interpreter	ABI	Platform	Reset
eeroctl-3.4.1-py3-none-any.whl 224.6 kB Oct 12, 2026	Python 3	none	any	Details

Total release size: 395.5 kB

Release files / eeroctl-3.4.1.tar.gz

Download URL	eeroctl-3.4.1.tar.gz
Size	170.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`8c9f7afee28a37d96c6c4b43ea7efb10a87425569b138633b01d9e3c7f7269e7`
BLAKE2b-256 checksum How to use checksums	`f44858445bbb2e1447ebadcfdf1a6c05feb7ccf291544a18a07863d77777736d`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / eeroctl-3.4.1-py3-none-any.whl

Download URL	eeroctl-3.4.1-py3-none-any.whl
Size	224.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9f673f87b745fc868d542367443e6057fc7f5677eaae9d79ef3997c4b7f384cc`
BLAKE2b-256 checksum How to use checksums	`2142db11a822a74a6fdd6480dc07a32516a497eaeec545af981b22cfa07541b9`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`