A CLI for https://kroki.io.

By default, the diagram type will be inferred from the diagram file extension and the default output format will be SVG.

Long format:

The output format can also be inferred from the output file using the --out-file flag:

Read from stdin:

By default, when reading from stdin using -, the result will be output to stdout. If you want to output to a file you can use -o:

Similarly, you can also output to stdout when reading from a file using the special value - with the --out-file flag:

The releases page provides binaries for each version to download.

You can also install using Pixi:

Alternatively, you can install the package directly from source. The compiled binary will be put into $GOPATH/bin/ or $HOME/go/bin/ if $GOPATH is not set:

To configure the endpoint, you can use a configuration file. The CLI will look for the following locations:

• /etc/kroki.yml

• $HOME/kroki.yml

• kroki.yml

You can also specify an alternate config file using the --config flag:

The config file should contain the endpoint URL and the HTTP timeout. By default, Kroki will use the demonstration server: https://demo.kroki.io and a timeout of 20 seconds.

Example:

If you don’t want to use a file you can also use the following environment variables:

• KROKI_ENDPOINT

• KROKI_TIMEOUT