Cloudflare TUI

A terminal user interface for managing Cloudflare DNS zones and records, inspired by k9s and gitui.

Features

• View all DNS zones in your Cloudflare account
• List DNS records for any zone
• Add, edit, and delete DNS records
• Filter zones and records with /
• Keyboard-driven interface

Installation

go install github.com/shyim/cloudflare-tui@latest

Or build from source:

git clone https://github.com/shyim/cloudflare-tui
cd cloudflare-tui
go build -o cloudflare-tui .

Configuration

Create a Cloudflare API token at https://dash.cloudflare.com/profile/api-tokens

Required permissions:

• Zone - DNS - Edit
• Zone - Zone - Read

Using Profiles (Recommended)

Profiles allow you to store multiple Cloudflare accounts and switch between them easily.

# Add a new profile
cloudflare-tui -add-profile personal
# You'll be prompted for the API token

# Add another profile
cloudflare-tui -add-profile work

# List all profiles (* marks default)
cloudflare-tui -list-profiles

# Set default profile
cloudflare-tui -set-default work

# Use a specific profile
cloudflare-tui -profile personal

# Remove a profile
cloudflare-tui -remove-profile old-account

Config file location: ~/.config/cloudflare-tui/config.yaml

Using Environment Variables

Set the token as an environment variable:

export CLOUDFLARE_API_TOKEN=your_token_here

Or create a .env file:

CLOUDFLARE_API_TOKEN=your_token_here

Token Priority

1. -profile flag (if specified)
2. CLOUDFLARE_API_TOKEN environment variable
3. Default profile from config file

Usage

cloudflare-tui

Keyboard Shortcuts

Navigation

Key	Action
Enter	Select zone / Edit record
Esc	Go back to zones
j / Down	Move down
k / Up	Move up
g	Go to top
G	Go to bottom

Actions

Key	Action
a	Add new DNS record
d	Delete selected record
e / Enter	Edit selected record
r	Refresh current view

General

Key	Action
/	Filter items
?	Show help
q	Quit application

License

MIT