---

site: protos.rip

page: compatibility

---

                                    __ 
  _________  ____ ___  ____  ____ _/ /_
 / ___/ __ \/ __ `__ \/ __ \/ __ `/ __/
/ /__/ /_/ / / / / / / /_/ / /_/ / /_  
\___/\____/_/ /_/ /_/ .___/\__,_/\__/  
                   /_/

# buf cli compatibility

works with buf cli >= v1.67.0.

unfamiliar with buf cli? check out the [official docs](https://buf.build/docs/cli/) first.

## what works

### dependencies

resolve, lock, and build against remote dependencies.

```yaml
deps:
  - protos.rip/acme/petapis
```

```bash
buf dep update
buf dep graph
buf build
buf generate
```

### remote code generation

run `buf generate` with hosted community plugins, including `protocolbuffers/go` and `bufbuild/es`.

all paid plans include unlimited cached generations, served as fast R2 cache hits. uncached compilations have monthly fair-use allowances and container runner concurrency limits:

plan	uncached compilations	concurrent container runners
Solo	2,000/month	1
Team	10,000/month	5

anonymous cached hits are open. anonymous uncached misses are strictly rate-limited to 5/hour per IP. [create a free account](/dashboard) to continue beyond the anonymous limit.

### auth

```bash
buf registry login protos.rip  # browser flow
echo $PROTORIP_TOKEN | buf registry login protos.rip --token-stdin  # ci / headless
buf registry whoami
```

### publishing

create a module and push commits (on `main` by default, or tagged with `--label`).

```bash
buf registry module create protos.rip/scope/module
buf push
buf push --label v1.0.0
```

### module and label management

full management of modules, labels, and commits.

```bash
buf registry module create / info / list / update / delete
buf registry label create / info / list / archive / unarchive
buf registry commit list / info
```

## not supported

alpha/beta CLI features: `buf alpha registry token` (use the dashboard for API keys), `buf beta registry webhook`, `buf registry sdk info`.

cross-registry dependencies: buf has experimental cross-registry federation but relies on a hardcoded allowlist that does not include protos.rip. ensure all modules in your dependency chain are published to protos.rip. we maintain a handful of well-known [curated mirrors](/registry) that should meet most needs.

## compatibility target

protos.rip implements [`bufbuild/registry-proto`](https://github.com/bufbuild/registry-proto) (the BSR protocol) v1 stable services. some other non-stable services are provided for buf cli compatibility.

last tested with buf cli v1.67.0 (april 2026).

[← Back](/)