A modern CLI for the Gandi v5 REST API — manage your domains and LiveDNS records from the terminal.

Website · Documentation

---

Features

• Domain management — list registered domains with expiry dates and statuses, renew them for one or more years, and toggle auto-renew.
• Full DNS control — list, create, update, and delete LiveDNS records with custom TTLs and every standard record type.
• Web redirects — manage Gandi web forwarding with 301/302 rules straight from the terminal.
• Permission doctor — gandi doctor reports your token's name, expiry, and scopes, and shows which commands each scope unlocks.
• PAT authentication — fine-grained, least-privilege Gandi Personal Access Tokens, with graceful guidance when a token is missing or rejected.
• Script & AI friendly — add --json to any command for structured output, non-zero exit codes on failure, and --yes to skip confirmations.

Install

npm install -g @kud/gandi-cli

Usage

# Domains
gandi domain list
gandi domain info example.com
gandi domain renew example.com --duration 2

# DNS
gandi dns list example.com
gandi dns set example.com A www 1.2.3.4 --ttl 300
gandi dns add example.com A www 5.6.7.8

# Redirects
gandi redirect add example.com www https://example.org

# Doctor & scripting
gandi doctor
gandi dns list example.com --json | jq '.[].name'

Development

git clone https://github.com/kud/gandi-cli.git
cd gandi-cli
npm install
npm run dev -- doctor

---

📚 Full documentation → gandi-cli/docs