The official CLI, a presentation layer over github.com/internetdata/sdk-go/v2.
Public repo: github.com/internetdata/cli, with gitea as a second push URL.
Structure: a flat dispatch in main.go, one cmd_<name>.go per command,
per-command completion predictors in completions.go, and output machinery in
lib/. It looks up an address, an AS or a domain (since 1.5.0), and lists,
describes and downloads the databases.
- An AS (
AS15169) or a domain (example.com) is a lookup too, by the SDK'sLookupASNandLookupDomain: one request each, never cached, never batched, answered after the addresses in the order typed. Only a TYPED argument is one: a list, piped or in a file, is read for addresses, so a log full of hostnames costs no domain lookups.classifydecides: an address, range or CIDR, thenAS<n>, then a file that exists (a list file reads like a domain), then a domain's shape (isDomain: LDH labels, a top label not all digits, so8.8.8.888is refused here rather than sent). - Each kind has its own columns:
lib.Columns,ASNColumnsandDomainColumns, each append-only, aslib.Columnssays, and the writers take the kind with every answer. Twice a field went in beforetrial_expiredinstead, each chosen over appending it: 1.6.0'shosted_domains.domainsbeside its total, and 1.7.0's ten AS fields,ranktohosted_domains.domains, afterprefixes. 1.8.0 appendedcap_reachedaftertrial_expired, the spec's order, so the two plan-state flags end every kind's columns (TestPlanStateComesLast). 1.9.0 put a domain's five new members in the answer's order,hostingandcohosted_domains.*after the records andweb.*tobacklinks.*afterdisposable.*, moving the ranges and the disposable detail four columns right, chosen over appending them. Ask again for the next field rather than place it by any of these.web.linksis the first object inside an object:--fieldtakes it, andkeepcopies a selected field at any depth. A CSV's header is its first answer's kind, so a CSV of two kinds is refused (lib.ErrMixedCSV), before any request when the arguments alone mix them. A--fieldis checked against the kinds the arguments ask for (answerKinds): addresses always, as stdin may add them. An AS's error line names it by its number,{"asn":15169,...}, and its JSON key isAS<n>however it was typed. - The AS whois record is a map in the SDK, so its 39 columns come from the
record the spec's paid example documents, and
TestASNWhoisColumnsAreTheDocumentedKeysholds them to that answer's keys, whereTestColumnsAreTheSDKsFieldsholds every other column to the SDK's types. - Keys are default-deny: a key without the
db.downloadscope looks addresses up and is refused by every database call, as a 401. So database errors go throughexplainDatabase, which names the scope, an address the allowed addresses leave out and the license (NOT_LICENSED,LICENSE_EXPIRED) apart, and leaves any other 403, asKEY_OVER_HTTP, to the API's code;checkKeyvalidates a key at login with a lookup, never the listing first. Since 2026-11-13 a key its owner tookip.lookupfrom is refused every lookup as a 403 (notwhoami: the API's source checks no scope on the account call, 2026-11-15), so login asks the listing after a 403 and stores a key that answers it, with a warning. Never on anhttp:base URL: the listing's host redirects plain HTTP to HTTPS and Go keeps the key across it, so a build without that guard stored a key the lookup refused for plain HTTP (2026-11-14). A lookup's 403 is never a plan, and the API's message names its reason, soexplainadds no hint to one. - Calls go to
https://api.internetdata.io, sign-in to the apex, which the SDK'sclient.Oauthderives from the base URL (api.dropped,api-<env>.becoming<env>.);TestSignInGoesToTheApexAndTheRestToTheAPIHostpins both. The apex answers the database paths too, so a session may hold it:signupURL()maps the apex toapp., a three-labelE.internetdata.iotoapp-E.internetdata.io, and anapi-labeled host keeps the sibling shape.cmd_signup_test.gopins it.
GitHub release (its notes are the version's CHANGELOG.md section), ghcr
(public, anonymous pull, 1.9.0 and latest), apt and go install were each
verified serving 1.9.0. The image carries OCI labels for the site, docs, source
and license, and its index's description annotation is what GitHub's package
page shows. apt is signed since 2026-11-10: InRelease, Release.gpg and
public.key (fingerprint 590AB7732517F95B056ED35317EA110D248C1B73), and the
README installs it with signed-by; a fresh bookworm installed 1.9.0 that way.
Its index lists all 32 versions, 1.0.0 to 1.9.0. The tap's formula names 1.9.0
with the release's own checksums. The tap's SECURITY.md and README are kept by
hand: the release job stages only Formula/. Chocolatey approved every version
through 1.9.0, each after a human's review.
winget took its first version, 1.4.7 as InternetData.CLI, on 2026-11-03
(microsoft/winget-pkgs#441588), and every later one is the release's winget
job, which must go green. The job copies the last version's locale
Description forward, so 1.5.0's was rewritten on its PR's branch for the
lookups. Every version through 1.9.0 (#484930) merged but 1.8.3, whose #484836
the validator holds as Validation-Installation-Error though its hashes match
the release's zips. The job posts the CLA agree when a PR reads Needs-CLA,
which none since 1.4.12 has.