# Aranya — vibecluster API

> Connect-RPC/protobuf API for managing GPU vibeclusters on Kubernetes.
> The contract is self-describing at runtime via gRPC reflection.

## Introspect the API (gRPC reflection)

Both v1 and v1alpha reflection protocols are served; no auth required:

    grpcurl vibecluster.ai:443 list
    grpcurl vibecluster.ai:443 describe vibecluster.v1alpha.NodesService

## Docs

- https://vibecluster.ai/api-reference — HTML catalog of all services/methods
  (append ?format=json for machine-readable JSON)
- https://vibecluster.ai/.well-known/api-catalog — RFC 9727 linkset
- Protos (source of truth): https://gitlab.com/aranya-tech/protos
  (proto/vibecluster/v1alpha/)

## Auth

Data RPCs require a bearer JWT (WorkOS OIDC session or CLI token).
Reflection and these discovery endpoints are unauthenticated.