gidinet

A modern, simple CLI for GiDiNet / QuickServiceBox reseller accounts. Manage your domains, DNS records, contacts and renewals straight from the terminal.

$ gidinet expiring --days 30
SERVICE            TYPE    ENDS        LEFT  RENEWAL    AUTO
onlyinitaly.it     domain  2026-05-27  -16d  12.20 EUR  no
beyondthelines.it  domain  2026-06-15    3d   6.70 EUR  no
mattiatrapani.com  domain  2026-07-02   19d  13.20 EUR  yes

Install

npm install -g @16bit/gidinet

Or run it without installing:

npx @16bit/gidinet domains

Requires Node.js 20 or newer.

Authentication

The CLI talks to the QuickServiceBox reseller API and needs your reseller username and password. Credentials are resolved in this order:

1. -u/--username and -p/--password flags
2. GIDINET_USERNAME / GIDINET_PASSWORD environment variables
3. The saved config file (gidinet login)

The quickest way to get going:

gidinet login          # prompts for username + password, verifies, saves them

Credentials are stored at ~/.config/gidinet/config.json with 0600 permissions. Remove them with gidinet logout.

Multiple accounts

If you manage more than one reseller account, save each under a name and switch between them:

gidinet login --name personal     # saves and selects "personal"
gidinet login --name work         # saves and selects "work"

gidinet accounts                  # list them (● marks the current one)
gidinet accounts use personal     # switch the default account
gidinet accounts rm work          # forget one

gidinet -a work domains           # run a single command against "work"

-a/--account picks a saved account for one command without changing the current one.

Commands

| Command | Description | | --- | --- | | gidinet login | Save and verify reseller credentials | | gidinet logout | Remove saved credentials | | gidinet whoami | Show the active account and credential source | | gidinet check <domains...> | Check domain availability (read-only, no charge) | | gidinet domains | List the domains on the account | | gidinet domain <domain> | Show full detail for one domain (status, dates, contacts) | | gidinet expiring | List services approaching expiry, soonest first | | gidinet contacts | List the contacts (anagrafiche) on the account | | gidinet accounts | List, switch (use) and remove (rm) saved accounts | | gidinet ns <domain> <ns...> | Replace a domain's authoritative nameservers | | gidinet dns list <domain> | List DNS records | | gidinet dns add <domain> <type> <host> <data> | Add a DNS record | | gidinet dns delete <domain> <type> <host> <data> | Delete a DNS record |

Add --json to any command for machine-readable output, ideal for scripting:

gidinet --json expiring | jq '.[] | select(.daysLeft < 14) | .key'

Examples

# Is a domain free?
gidinet check mycoolstartup.com mycoolstartup.it

# All domains using GiDiNet's own nameservers
gidinet domains --gidinet-dns

# Every domain, across all pages, filtered by name
gidinet domains --all --filter waste

# DNS records for a zone
gidinet dns list example.com

# Point www at an IP
gidinet dns add example.com A www 203.0.113.10 --ttl 3600

# A mail record with priority
gidinet dns add example.com MX @ mail.example.com --priority 10

# Delete a record (asks for confirmation, or pass -y)
gidinet dns delete example.com A www 203.0.113.10 -y

# Move a domain onto GiDiNet nameservers
gidinet ns example.com dnsl1.gidinet.com dnsl2.gidinet.com

Destructive operations (dns add/delete, ns) ask for confirmation when run interactively and refuse to run non-interactively unless you pass -y/--yes.

How it works

GiDiNet exposes a SOAP API (CoreAPI + DNSAPI). This CLI builds the SOAP envelopes directly over fetch — no WSDL round-trip per call — so it starts fast and ships with a tiny dependency footprint.

License

MIT © 16bit Srl