gRPC Command line interface for any gRPC service in Go
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


grpccmd is a CLI generator for any gRPC service in Go. While the CLI is written in Go the CLI should be able to talk to any gRPC server in any language. The grpccmd is implemented as a plugin to protoc.


To install the protoc plugin binary run:

go get -u


To generate code for a CLI run this command.

protoc path/to/file.proto --grpccmd_out=.

It is recommended to place the above command as a Go generate comment in a main.go file.

Create a main.go file that references the generated code.

package main

import (

	// Import grpccmd generated code
	_ ""

//go:generate protoc -I ../internal/pb/ ../internal/pb/example.proto --grpccmd_out=../internal/pb/

func main() {
		"Make calls to the Example service",
		"example-rpc command has been autogenerated via the protoc plugin",
	if err := grpccmd.Execute(); err != nil {

The above code is part of a working example in the ./example directory from this project.

To try it out run:

# Start the server
go run ./example/server/main.go
# Install the CLI
go install ./example/example-rpc
# Make a few calls to the server
example-rpc --addr localhost:50051 example getNumber
example-rpc --addr localhost:50051 example echo --input '{"str":"this is a string", "int": 42, "dbl": 6.9, "kv" : {"key":"value"}}'

Server Code

The grpccmd wraps the normal grpc protoc plugin so the generated code can be used by the server as well. Whether you do so is up to you as it is easy enough to generate the code twice, once for the server without grpccmd and once for the client with grpccmd. Generating the code twice allows the client and server to be decoupled since they do not have to import the same package.