// STRYKE-GRPC — REFLECTION-BASED gRPC CLIENT FOR STRYKE // LIKE grpcurl, AS A PACKAGE

stryke package · CLI launcher grpc · Rust helper stryke-grpc-helper · opt-in (kept out of stryke core)

Report GitHub Issues
// Color scheme

>_STRYKE-GRPC

Describe, call, decode — all over NDJSON. Generic, reflection-based gRPC client for stryke — list services, describe methods, call unary RPCs with JSON in/out. Like grpcurl but as a stryke package, NDJSON-friendly, and statically linked.

Install

# build the helper binary, install as a stryke package
cd ~/projects/stryke-grpc
cargo build --release
s pkg install -g .

# one-liner
make install

# verify
grpc --help

After install, grpc --help works from anywhere on PATH (assuming ~/.stryke/bin/ is on PATH). The stryke library is auto-discoverable to any project that depends on the package via [deps] grpc = { path = "..." } or, when published, by name.

CLI: grpc

list services on a targetgrpc list api.example.com:50051
describe a methodgrpc describe api.example.com:50051 helloworld.Greeter/SayHello
call a unary RPCgrpc call api.example.com:50051 helloworld.Greeter/SayHello '{"name":"world"}'
local test servergrpc call localhost:50051 -plaintext echo.Echo/Echo '{"msg":"hi"}'

The full flag matrix lives in the README "CLI" section.

Why a package, not a builtin

Reflection-driven means no .proto files needed on the client side. Targets that expose the gRPC reflection service work out of the box.

The stryke side is a thin NDJSON-pipe wrapper; the heavy code lives in the stryke-grpc-helper sidecar binary and is loaded on demand. Core stryke is never linked against this package's deps.

Helper protocol

The stryke-grpc-helper sidecar speaks newline-delimited JSON over stdin/stdout. The stryke library shells out per call and pipes structured data both ways. This keeps stryke startup small while making the package's surface area available on demand.

# manual invocation (debugging only)
echo '{"op":"version"}' | stryke-grpc-helper

Layout

stryke-grpc/
├── Cargo.toml             # bin = stryke-grpc-helper (publish = false)
├── src/
│   └── main.rs           # helper binary entry point
├── lib/                   # stryke .stk wrapper(s)
├── stryke.toml            # stryke package manifest
├── t/                     # zunit-style tests
├── examples/              # runnable .stk examples
├── Makefile               # `make install` builds + installs
└── docs/                  # this site (GitHub Pages)

Sibling packages

Part of the stryke connector family. Browse the others via the MenkeTechnologiesMeta umbrella repo (Tier 2):