chinmayrelkar/bawarchi

API spec to cli in a :flash:

stars

commits

primary language

Jul 20, 2026

updated

README

bawarchi

Generate standalone CLIs from API specs. Point bawarchi at an OpenAPI 3.x or Swagger 2.0 document (file or HTTPS URL) or a .proto file, and it compiles a self-contained command-line tool for that API.

REST (OpenAPI 3.x / Swagger 2.0) — typed flags, request bodies, headers, arrays, $ref resolution, and standardized exit codes.
gRPC (.proto) — generated CLIs shell out to grpcurl; TLS by default.

Install

With Go:

go install github.com/chinmayrelkar/bawarchi/cmd/bawarchi@latest

Or download a prebuilt binary (linux/darwin/windows, amd64/arm64) from the releases page — each release includes a checksums.txt to verify the download.

Quick start (REST)

# Generate a CLI from a spec (file or https:// URL)
bawarchi add https://api.example.com/openapi.yaml

# Put it on your PATH
bawarchi install example-api

# Use it — auth and base URL come from environment variables
export EXAMPLE_API__API_KEY=sk-...
example-api --help

Quick start (gRPC)

bawarchi add ./greeter.proto
bawarchi install greeter

export GREETER__AUTH_TOKEN=...
greeter --help

Generated gRPC CLIs shell out to grpcurl and connect over TLS by default. Control behavior with annotations in the .proto file (anywhere in the file, as a // comment):

Annotation	Effect
`// @server: host:port`	Sets the default server address (falls back to `localhost:50051` with a warning if omitted)
`// @service: com.example.v1`	Sets the fully-qualified gRPC service package/prefix used to build the method path
`// @noauth`	Marks the service as not requiring a bearer token; the generated CLI skips the auth-required check

Useful commands

Command	Description
`bawarchi add <spec>`	Generate, compile, and register a CLI (`--dry-run` to preview source, `--name`/`--base-url` to override)
`bawarchi list`	List generated CLIs
`bawarchi info <name>`	Show details for a CLI
`bawarchi update <name>`	Re-fetch the spec and regenerate (`--source` to switch spec sources, `--base-url` to override; falls back to the cached spec if the source is offline)
`bawarchi install <name>`	Symlink a CLI onto your PATH (`--dir` to override the install directory, default `~/.local/bin`)
`bawarchi remove <name>`	Delete a CLI and its cached spec
`bawarchi --version`	Print the bawarchi version

Runtime configuration of generated CLIs

Generated CLIs read configuration from environment variables (prefix derived from the API name, e.g. EXAMPLE_API__...):

NAME__API_KEY / NAME__TOKEN / NAME__CREDENTIALS — auth, depending on the spec's security scheme
NAME__BASE_URL — override the base URL
NAME__SERVER=<index> — select one of a multi-server spec's predefined servers
gRPC: NAME__SERVER_ADDR — override the server address (overrides // @server: in the proto)

Generated REST CLIs exit 0 on success, 4 on a 4xx response, and 5 on a 5xx response.

Development

go build ./...
go vet ./...
go test ./...

CI runs gofmt, vet, build, and tests on every pull request and on every push to main. Once CI is green on main, an auto-release workflow automatically bumps a semver tag (feat: commits → minor, BREAKING CHANGE/!: → major, everything else → patch) and runs GoReleaser to publish cross-platform binaries — no manual tagging needed. .github/workflows/release.yml remains as a manual fallback for hand-pushed tags.

License

MIT

Contributors

chinmayrelkar

48 commits

See what people are saying

Hacker News (2)

Show HN: CLI to Churn Out CLIs

3 points · Aug 21, 2026

Similar repos

solo-io/protoc-gen-openapi

Compile Google protobufs to openAPI v3 specs

124

fullstorydev/grpcurl

Like cURL, but for gRPC: Command-line tool for interacting with gRPC servers

12,809

apicollective/apibuilder-cli

Command line interface to apibuilder

johanbrandhorst/grpc-gateway-boilerplate

All the boilerplate you need to get started with writing grpc-gateway powered REST services in Go

497

gengo/grpc-gateway

gRPC to JSON proxy generator following the gRPC HTTP spec

19,998

OpenAPITools/openapi-generator-cli

A node package wrapper for https://github.com/OpenAPITools/openapi-generator

1,973

HarmoWatch/openapi-generator-cli

A node package wrapper for https://github.com/OpenAPITools/openapi-generator

1,973

grpc-ecosystem/grpc-gateway

gRPC to JSON proxy generator following the gRPC HTTP spec

20,000

Languages

100.0%

chinmayrelkar/bawarchi

API spec to cli in a :flash:

stars

commits

primary language

Jul 20, 2026

updated

README

bawarchi

REST (OpenAPI 3.x / Swagger 2.0) — typed flags, request bodies, headers, arrays, $ref resolution, and standardized exit codes.
gRPC (.proto) — generated CLIs shell out to grpcurl; TLS by default.

Install

With Go:

go install github.com/chinmayrelkar/bawarchi/cmd/bawarchi@latest

Or download a prebuilt binary (linux/darwin/windows, amd64/arm64) from the releases page — each release includes a checksums.txt to verify the download.

Quick start (REST)

# Generate a CLI from a spec (file or https:// URL)
bawarchi add https://api.example.com/openapi.yaml

# Put it on your PATH
bawarchi install example-api

# Use it — auth and base URL come from environment variables
export EXAMPLE_API__API_KEY=sk-...
example-api --help

Quick start (gRPC)

bawarchi add ./greeter.proto
bawarchi install greeter

export GREETER__AUTH_TOKEN=...
greeter --help

Generated gRPC CLIs shell out to grpcurl and connect over TLS by default. Control behavior with annotations in the .proto file (anywhere in the file, as a // comment):

Annotation	Effect
`// @server: host:port`	Sets the default server address (falls back to `localhost:50051` with a warning if omitted)
`// @service: com.example.v1`	Sets the fully-qualified gRPC service package/prefix used to build the method path
`// @noauth`	Marks the service as not requiring a bearer token; the generated CLI skips the auth-required check

Useful commands

Command	Description
`bawarchi add <spec>`	Generate, compile, and register a CLI (`--dry-run` to preview source, `--name`/`--base-url` to override)
`bawarchi list`	List generated CLIs
`bawarchi info <name>`	Show details for a CLI
`bawarchi update <name>`	Re-fetch the spec and regenerate (`--source` to switch spec sources, `--base-url` to override; falls back to the cached spec if the source is offline)
`bawarchi install <name>`	Symlink a CLI onto your PATH (`--dir` to override the install directory, default `~/.local/bin`)
`bawarchi remove <name>`	Delete a CLI and its cached spec
`bawarchi --version`	Print the bawarchi version

Runtime configuration of generated CLIs

Generated CLIs read configuration from environment variables (prefix derived from the API name, e.g. EXAMPLE_API__...):

NAME__API_KEY / NAME__TOKEN / NAME__CREDENTIALS — auth, depending on the spec's security scheme
NAME__BASE_URL — override the base URL
NAME__SERVER=<index> — select one of a multi-server spec's predefined servers
gRPC: NAME__SERVER_ADDR — override the server address (overrides // @server: in the proto)

Generated REST CLIs exit 0 on success, 4 on a 4xx response, and 5 on a 5xx response.

Development

go build ./...
go vet ./...
go test ./...

License

MIT

See what people are saying

Hacker News (2)

Show HN: CLI to Churn Out CLIs

3 points · Aug 21, 2026

Similar repos

solo-io/protoc-gen-openapi

Compile Google protobufs to openAPI v3 specs

124

fullstorydev/grpcurl

Like cURL, but for gRPC: Command-line tool for interacting with gRPC servers

12,809

apicollective/apibuilder-cli

Command line interface to apibuilder

johanbrandhorst/grpc-gateway-boilerplate

All the boilerplate you need to get started with writing grpc-gateway powered REST services in Go

497

gengo/grpc-gateway

gRPC to JSON proxy generator following the gRPC HTTP spec

19,998

OpenAPITools/openapi-generator-cli

A node package wrapper for https://github.com/OpenAPITools/openapi-generator

1,973

HarmoWatch/openapi-generator-cli

A node package wrapper for https://github.com/OpenAPITools/openapi-generator

1,973

grpc-ecosystem/grpc-gateway

gRPC to JSON proxy generator following the gRPC HTTP spec

20,000

Contributors

chinmayrelkar

48 commits

Languages

100.0%