cloudflaredy

TUI for managing Cloudflare Zero Trust tunnels,route IPs and DNS records.

Install

curl -fsSL https://coody.app/cloudflaredy/install.sh | bash

The installer automatically detects your OS and package manager and installs all dependencies (gum, cloudflared, jq, curl) before downloading cloudflaredy.

Supported environments

OS / Distro	Package manager
macOS	Homebrew
Ubuntu / Debian	apt + charm.sh repo
Fedora / RHEL	dnf + charm.sh repo
Arch Linux	pacman
Alpine	apk + go fallback
Any (fallback)	GitHub binary release

Usage

cloudflaredy

On first run go to ⚙️ Configure credentials and set:

• CF_API_TOKEN — API Token with DNS:Edit + Zero Trust:Edit permissions
• ZONE_ID — Zone ID from your domain's Cloudflare overview page
• TUNNEL_ID — (optional) default tunnel

Features

Feature	Description
🔍 Scan instances	Finds all cloudflared in PATH, processes, systemd, Docker
🚇 List tunnels	Paginated list of all account tunnels
🔀 Select tunnel	Interactive picker to set the active tunnel
🌐 List route IPs	All private network IP routes for active tunnel
🗑 Delete a route IP	Pick one CIDR to remove
💣 Delete all IPs	Bulk delete with confirmation
📋 List route DNS	All CNAME records for active tunnel
🗑 Delete a DNS	Pick one CNAME to remove
💣 Delete all DNS	Bulk delete via Cloudflare API
⚙️ Configure	Credentials stored in ~/.cloudflaredy/config (chmod 600)
📝 View log	Paginated log viewer inside the TUI

Project structure

cloudflaredy/
├── install.sh            ← one-liner installer
├── cloudflaredy.sh       ← entrypoint
├── lib/
│   ├── ui.sh             ← gum theme, helpers, main menu
│   ├── config.sh         ← load/save/assert credentials
│   ├── deps.sh           ← runtime dependency check
│   ├── scan.sh           ← system-wide cloudflared scan
│   ├── tunnels.sh        ← tunnel list + selection
│   ├── route_ip.sh       ← route IP operations
│   └── route_dns.sh      ← route DNS/CNAME operations
└── README.md

Config & logs

Path	Description
~/.cloudflaredy/config	Credentials (chmod 600)
~/.cloudflaredy/cloudflaredy.log	Timestamped operation log

Uninstall

rm -rf ~/.cloudflaredy
rm -f ~/.local/bin/cloudflaredy

License

MIT