NAME

module - Go module proxy lookups (proxy.golang.org)

SYNOPSIS

module

DESCRIPTION

module wraps the four read endpoints of the Go module proxy protocol. The proxy is the public mirror that go get and go mod download consult; the data is canonical for "what does the Go ecosystem think about this module".

Every leaf takes a module path as the first positional. Paths use the canonical form <host>/<owner>/<repo>[/<subpath>][/v<N>]:

github.com/urfave/cli/v3
github.com/stretchr/testify
golang.org/x/mod

Paths are case-sensitive at the proxy level. Module paths that require !-encoding (uppercase letters in the path) are handled by the client; you pass the regular form.

Operating model for an agent calling these tools:

- Reads only. Calls are cheap from a correctness standpoint;
  cache the result if you need to call repeatedly within a
  session.
- Errors propagate as Go error strings. A 404 from the proxy
  surfaces as a wrapped HTTP error; the agent should treat
  that as "the module does not exist or has been removed".
- The proxy data is eventually consistent with whatever the
  module's repo publishes. A brand-new tag may take a few
  minutes to appear in `module versions`.

Usage:

module [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]

COMMANDS

latest

latest version of a module

versions

all known versions of a module

info

metadata for a specific version

gomod

raw go.mod text for a specific version