zorath-env v0.3.8 is now available. This release combines two updates focused on stability, developer experience, and CI/CD integration.
What is zorath-env?
zorath-env (command: zenv) is a fast, open-source CLI tool that validates .env files against JSON or YAML schemas. It catches configuration errors, type mismatches, and leaked secrets before they reach production.
Written in Rust, it runs entirely locally with zero dependencies and no telemetry. Install it once and it works with any tech stack.
v0.3.8 Highlights (January 25, 2026)
Cache Statistics
New zenv cache stats command shows cache health at a glance.
zenv cache stats
Cache Statistics
================
Directory: ~/.cache/zorath-env
Status: Active
Schemas: 3
Size: 12.4 KB
TTL: 1h 0m
GitHub Secrets Export
Export your .env directly to GitHub CLI commands.
zenv export --format github-secrets
#!/bin/sh
# Generated by zenv
gh secret set DATABASE_URL --body 'postgres://localhost/app'
gh secret set API_KEY --body 'sk_live_abc123'
Run the output to set all your repository secrets in one go.
Typo Detection in Diff
The diff command now suggests corrections for possible typos.
zenv diff .env.local .env.prod
Different keys:
DATABSE_URL vs DATABASE_URL
Did you mean DATABASE_URL? (edit distance: 1)
Structured Exit Codes
CI/CD pipelines now get specific exit codes:
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Validation failures |
| 2 | Input/file errors |
| 3 | Schema parse errors |
Secret Masking in Dry Run
The fix --dry-run command now masks sensitive values.
zenv fix --dry-run
Would add:
+ API_KEY=***MASKED*** (schema default)
+ DATABASE_URL=***MASKED*** (schema default)
v0.3.7 Highlights (January 20, 2026)
CI/CD Templates
Generate ready-to-use CI configuration with zenv template.
# GitHub Actions workflow
zenv template github --output .github/workflows/env-validation.yml
# GitLab CI
zenv template gitlab --output .gitlab-ci.yml
# CircleCI
zenv template circleci --output .circleci/config.yml
Duplicate Key Detection
zenv now warns when .env files contain duplicate keys.
Warning: Duplicate keys found in .env:
DATABASE_URL defined on line 5 (overwrites line 2)
API_KEY defined on line 12 (overwrites line 8)
Library APIs for Embedding
zenv is now both a CLI and a library. Embed validation in your Rust projects.
use zorath_env::commands::check;
use zorath_env::commands::export;
// Validate files
let result = check::validate_files("env.schema.json", ".env", None)?;
// Export to string
let output = export::export_to_string(&env_vars, "k8s", None)?;
Version-Aware Build System
New build.rs detects stale cache and forces rebuilds when needed.
warning: zenv version changed: 0.3.6 -> 0.3.7
If you see stale build errors, run: cargo clean
Test Coverage
| Version | Unit Tests | Integration Tests | Total |
|---|---|---|---|
| v0.3.7 | 351 | 29 | 380 |
| v0.3.8 | 547 | 83 | 630 |
250 new tests added in v0.3.8 for comprehensive coverage.
Full Changelog
Added in v0.3.8
zenv cache statscommand- GitHub Secrets export format (
--format github-secrets) - Structured exit codes (1, 2, 3)
- Typo detection in diff command
- Config key validation for
.zenvrc - Actionable fix suggestions in check output
- Secret masking in
fix --dry-run - 250 new tests (630 total)
Added in v0.3.7
zenv templatecommand (GitHub, GitLab, CircleCI)- Duplicate key detection with line numbers
- Library APIs (
validate_files,export_to_string,generate) - 29 integration tests
- Version-aware build system
- Cargo aliases (fresh, rel, t, lint)
Installation
First-Time Install
cargo install zorath-env
Upgrade
cargo install zorath-env --force
Verify Installation
zenv version
# zenv v0.3.8
Resources
- Website: zorl.cloud/zenv
- Documentation: zorl.cloud/zenv/docs
- GitHub: github.com/zorl-engine/zorath-env
- Package: crates.io/crates/zorath-env
- Changelog: CHANGELOG.md
Ready to validate your environment variables?
cargo install zorath-env