Repo brief: fullstorydev/grpcurl

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T12:49:23.809Z · commit c54eac28fd8d

Verdict

Mixed — Slowing — last commit 3mo ago

• Last commit 3mo ago
• 33+ active contributors
• Distributed ownership (top contributor 45% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

grpcurl is a command-line tool that functions like cURL but for gRPC servers, allowing you to invoke RPC methods from the shell by converting JSON request data into protocol buffer binary encoding. It supports all gRPC method types (unary, server streaming, client streaming, bidirectional streaming) and can discover service schemas via server reflection, proto source files, or precompiled protoset descriptor files. Single-package architecture with cmd/grpcurl/grpcurl.go as the CLI entry point and library code at root level (grpcurl.go, format.go, desc_source.go) providing reusable primitives. Test infrastructure in internal/testing/ includes two runnable demo services (bankdemo and…

Start here

Open these first:

• cmd/grpcurl/grpcurl.go — Main CLI entry point that parses arguments, sets up gRPC connections, and orchestrates the entire tool's execution flow.
• grpcurl.go — Core package exposing InvokeRPC and primary APIs that all callers use to execute gRPC method invocations.
• invoke.go — Handles the actual gRPC unary/streaming RPC invocation logic, message marshaling, and response handling.
• desc_source.go — Abstracts descriptor sources (reflection, protoset files) so the tool can discover service schemas dynamically or statically.
• format.go — Converts protobuf messages to/from JSON, handling formatting options and encoding logic that bridges binary gRPC and…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/fullstorydev/grpcurl.git
cd grpcurl
go build -o grpcurl ./cmd/grpcurl
./grpcurl -h

Daily commands:

# Build the CLI tool
make build

# Or build directly
go build -o grpcurl ./cmd/grpcurl

# Test against the built-in demo server
cd internal/testing/cmd/testserver && go run testserver.go &
grpcurl -plaintext localhost:7777 list

# Test the full suite
go test ./...

Key cautions & unknowns

• Slowing — last commit 3mo ago
• Proto compilation dependencies: Tests rely on protoc being available (see download_protoc.sh)—some tests may fail if proto code generation hasn't run. TLS cert paths: internal/testing/tls/ contains hardcoded…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.