# ipinfo/cli

Official Command Line Interface for the IPinfo API (IP geolocation and other types of IP data)

Repository: https://github.com/ipinfo/cli
Canonical: https://ross.abutalabs.com/products/ipinfo-cli
Homepage: https://ipinfo.io/
Language: Go
License: Apache-2.0
License Family: permissive
Topics: ip-address, ip-lookup, ip-data, ip-geolocation, ipinfo, golang, cli
Last push: 2026-04-28T17:02:40+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 79, release rhythm 49, longevity 100
- inputs: {"age_days": 2140, "days_push": 127, "days_rel": 127, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2058, forks 208 (observed 2026-08-28T04:06:09.920207+00:00)

## What it is
The official command-line client for the IPinfo.io API, written in Go. It lets users look up IP geolocation, ASN, privacy detection, and related IP data individually, in bulk, or summarized, and includes utilities for filtering IPs and generating IP maps and CIDR lists.

## Use cases
- look up geolocation details for an IP address from the terminal
- bulk-enrich a list of IP addresses with ASN and company data
- filter IPv4 and IPv6 addresses out of a log file
- list all IPs in a CIDR range
- map the geographic locations of a set of IPs
- check whether an IP is a VPN, proxy, or Tor node
- summarize details for up to 1000 IPs at once

## When to choose
- you need quick IP intelligence from the command line or in shell scripts
- you want bulk IP lookups or summaries without writing API code
- you need IP filtering, CIDR expansion, or IP mapping utilities
- you want an official, well-maintained client for the IPinfo API

## When to avoid
- you need IP data without depending on the IPinfo API and its usage limits or paid plans
- you need programmatic integration inside an application rather than CLI usage (use an official SDK instead)
- you need fully offline IP lookups (use a downloadable MMDB database instead)

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, http-client, search-engine, geospatial, developer-tools
- domain: networking, security, developer-tools, apis
- platform: windows, bsd, cli, go, cross-platform
- tags: ip-geolocation, ip-lookup, ipinfo, asn, cidr, ip-address, bulk-lookup, command-line, linux, macos, docker

## Member repositories
- ipinfo/cli (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:09.920207+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:57:10.413766+00:00, confidence not recorded.
  - readme: https://github.com/ipinfo/cli (fetched 2026-08-28T04:06:09.920207+00:00, sha d519cc5b5c2d)
  - homepage: https://ipinfo.io/ (fetched 2026-08-29T10:37:26.183117+00:00, sha 0f5af4f11a78)
  - site_page: https://ipinfo.io/about (fetched 2026-08-29T10:37:26.197755+00:00, sha a2a36fad9e59)
  - site_page: https://ipinfo.io/pricing (fetched 2026-08-29T10:37:26.193544+00:00, sha 826a93f5ea5d)
  - site_page: https://ipinfo.io/developers (fetched 2026-08-29T10:37:26.195791+00:00, sha 97d7c76d1453)
- Data as of 2026-08-30T08:39:29.467469+00:00.