porkbun-cli

porkbun-cli

A command-line tool for managing DNS records and domains via the Porkbun API.

Configuration

Create ~/.config/porkbun-cli/config.toml with your API credentials:

api_key = "pk1_..."
secret_key = "sk1_..."

Each domain must have API access enabled in the Porkbun dashboard.

Usage

List domains:

porkbun-cli domains

List DNS records:

porkbun-cli dns list example.com

Create a record:

porkbun-cli dns create example.com -t A 1.2.3.4 --name www

Edit a record by ID:

porkbun-cli dns edit example.com 123456789 -t A 5.6.7.8 --name www

Delete a record:

porkbun-cli dns delete example.com 123456789

Use --headers before the subcommand to print column headers:

porkbun-cli --headers dns list example.com

Building

cargo build --release

Claude Code Plugin

This repo includes a Claude Code plugin with a porkbun-dns skill that teaches Claude how to manage DNS records via the CLI.

To install:

/plugin marketplace add jsvana/porkbun-cli
/plugin install porkbun-dns@porkbun-cli