# pkg.go.dev API

Route pkgsite-cli's pkg.go.dev API calls through the Package Firewall so search and package metadata respect your policy.

| | |
|---|---|
| API base URL | `https://packages.vulnes.is/go-dev/v1beta` |
| Ecosystem ID | `go-dev` |
| Plan | Free |
| Mode | filter; a single package or module document can be blocked whole |
| Cooldown | no |
| Default mirror | `https://pkg.go.dev` |

This proxies the pkg.go.dev API used by `pkgsite-cli`. It does not download modules; for that configure [Go modules](/package-firewall/clients/go.md).

## Automatic setup

```bash
vulnetix package-firewall go-dev
```

This writes only the `~/.netrc` entry. `pkgsite-cli` has no config file, so the command prints how to pass the API base.

## Use

```bash
alias pkgsite-cli='pkgsite-cli -api https://packages.vulnes.is/go-dev/v1beta'
pkgsite-cli search uuid
```

or per call:

```bash
pkgsite-cli -api https://packages.vulnes.is/go-dev/v1beta package github.com/google/go-cmp/cmp
```

`pkgsite-cli` sends the netrc credentials as Basic auth.

## Remove

There is no config file to remove. Drop the shared credential with `vulnetix package-firewall uninstall go-dev --remove-credentials`, which also breaks every other ecosystem that relies on it.
