Installation

Download Binary

Download pre-built binaries from the GitHub Releases page.

Choose the appropriate binary for your platform and add it to your PATH.

Install Using Go

Install directly from the Go toolchain:

go install github.com/UnitVectorY-Labs/json2mdplan@latest

Build from Source

Build the application from source code:

git clone https://github.com/UnitVectorY-Labs/json2mdplan.git
cd json2mdplan
go build -o json2mdplan

Authentication

json2mdplan requires Google Cloud credentials to access Gemini models for the --plan mode. The --convert mode does not require any authentication.

You will be charged for usage of Gemini models according to Google Cloud’s pricing.

Authenticate locally:

gcloud auth application-default login

Or use a service account:

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json

Set your project (can be specified with --project flag as well):

export GOOGLE_CLOUD_PROJECT=your-project-id