grpcli

library0.8.1jsnpmunverified

grpcli (v0.8.1) is a command-line client for interacting with gRPC servers. It allows connecting to any gRPC service, listing available methods, and calling methods using native JavaScript objects that are converted to protobuf messages. It supports configuration via .grpclirc file, automatic reconnection via standard gRPC backoff retries, and works with both proto2 and proto3. Released under BSD-2-Clause license, maintained on GitHub with low release cadence (last update 2018). Differentiators: REPL-like interactive mode, multiple config profiles, and no dependency on protoc compilation.

devops

npm install grpcli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GRPCLI

grpcli

devopsjavascriptv0.8.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

grpcli (CLI)

✓ npm install -g grpcli

✗ npm install grpcli (local install without -g will not add to PATH)

CLI is intended to be installed globally via -g

Install grpcli globally, connect to a gRPC service, list methods, and call one with JSON arguments.

# Install globally npm install -g grpcli # Run with a proto file and server details grpcli -f service.proto --ip=127.0.0.1 --port=50051 # Inside REPL, list methods: rpc list # Call method: rpc call MethodName {"key":"value"} # Example session: # [grpc+insecure://127.0.0.1:50051]# rpc list # listObjects(ListObjectsRequest) { # return ListObjectsResponse; # } # [grpc+insecure://127.0.0.1:50051]# rpc call listObjects {"offset":0,"limit":10} # { # "objects": { # "objects": [] # } # }

Debug

Known issues

breakinggrpc dependency may have native compilation issues on newer Node.js versions

fix

Use nvm to switch to Node.js 10 or 12; consider using grpc-js for pure JavaScript alternative

affects: >=0.8.1

deprecatedgrpc package is deprecated in favor of @grpc/grpc-js

fix

No official upgrade path; consider alternatives like grpcurl or prepare custom client

affects: >=0.7.5

gotchaProto file must be provided via -f option or config file; no dynamic service discovery

fix

Ensure .proto file path is correct and includes imports

affects: >=0.1.0

gotchaInsecure connections by default; use --insecure flag if server does not use TLS

fix

If server is plaintext, add --insecure to command-line

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'grpc'

grpc package native compilation failed or missing

fix

Install build tools (python, make, g++) and retry: npm install -g grpcli

Error: EACCES: permission denied, unlink '/usr/local/lib/node_modules/grpcli'

Global install without sudo on Unix systems

fix

Use sudo npm install -g grpcli or configure npm prefix

Error: Failed to load protobuf file: ENOENT: no such file or directory

Proto file path is incorrect

fix

Provide absolute path or use -d for directory and -f for filename

Upgrade

Version history

0.8.1latest on npm

Audit

Dependencies

grpcrequiredRequired for gRPC client functionality

protobufjsrequiredUsed for parsing .proto files and message serialization

Agent activity

8 hits · last 30 days

node

Resources

githubssh://git@github.com/nathangoulding/grpcli ↗

packagegrpcli ↗

homepagehttps://github.com/nathangoulding/grpcli#readme ↗