← Projects
MIT · Open source

gandi-cli

Manage Gandi domains & LiveDNS from your terminal — list, renew and edit records via the v5 API

Documentation →GitHub ↗

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