beginner⏱ 3 minutesevnx v0.2.1+

evnx convert

Command reference for evnx convert — flags, supported formats, transform values, glob patterns, and exit codes.

Prerequisites

Transform .env files into 14+ output formats including JSON, YAML, Kubernetes secrets, Terraform variables, and cloud provider configs.

Before you start

Run evnx convert without --to to open an interactive TUI format selector — no flags required.

Signature

Bash

evnx convert [OPTIONS]

All flags are optional. Omitting --to launches interactive mode.

Flag	Short	Type	Default	Description
`--env`	—	`path`	`.env`	Path to input `.env` file
`--to`	—	`string`	—	Target output format (omit for interactive selection)
`--output`	`-o`	`path`	—	Write output to file instead of stdout
`--include`	—	`glob`	—	Include only variables matching this pattern
`--exclude`	—	`glob`	—	Exclude variables matching this pattern
`--base64`	—	`bool`	`false`	Base64-encode all values before output
`--prefix`	—	`string`	—	Prepend a string to all variable names
`--transform`	—	`enum`	—	Transform key casing (see Transform values)
`--verbose`	`-v`	`bool`	`false`	Print debug output to stderr (global flag)
`--help`	`-h`	`bool`	`false`	Display help

--to has no -t short alias. --verbose / -v is a global flag on the top-level evnx command, not specific to convert.

Passed to --transform. Applied to every key in the output after --prefix is prepended.

Order of operations: filter → prefix → transform.

--include and --exclude accept simple glob patterns. --exclude is applied after --include.

Character classes and brace expansions ([abc], ) are not supported.

Code	Meaning
`0`	Conversion completed successfully
`1`	Failure — unknown format, parse error, or I/O error

Exit code 2 is used only by evnx diff, not by convert.