Chiko vs protoc-gen-doc

Chiko is a free, open-source desktop terminal interface for testing gRPC APIs. When a server exposes reflection, it can discover and browse available gRPC endpoints. Chiko creates formatted request templates, and requests can include Bearer-token authorization, custom headers, and other metadata. You can save requests as bookmarks and replay them later. The project lists importing and exporting grpcurl commands as completed features, and a release changelog records SSL connection support. Installation instructions cover Homebrew, Go installation, building from source, and prebuilt releases. Chiko is licensed under the MIT License and lists a Free plan at free, with no paid plans or usage limits stated. OAuth, API keys, proto-file import, and password protection for sensitive bookmarks are listed as work in progress. Felix Angga, identified as a software engineer, is the maker.

protoc-gen-doc is a documentation generator plugin for the Google Protocol Buffers compiler. It turns comments in .proto files into HTML, JSON, DocBook, or Markdown documentation, covering files, messages, fields, services and methods, enums and values, and extensions. It supports proto2 and proto3, including both in the same context. You can exclude files with path patterns and omit comments marked with the @exclude prefix. The plugin runs through protoc with the --doc_out and --doc_opt options; its source_relative flag places generated output in the same relative directory as the input. For customization, users can supply a Go template or use a stylesheet.css file to change HTML appearance. Installation options include Go, prebuilt releases, a Docker image, and a Maven Central package. It runs on Linux, macOS, and Windows and is self-hosted. The project is free under the MIT License, which allows use, modification, distribution, sublicensing, and sale under its terms. The license provides the software as is, without warranty.