EnvCheck

Utility toolkit for environment and configuration management — run, check, convert, analyze, generate, preview, batch, compare, export, config, status, and report. All entries are logged locally with timestamps for full traceability.

Commands

Each command (run, check, convert, analyze, generate, preview, batch, compare, export, config, status, report) works in two modes:

• No arguments: displays the 20 most recent entries from that command's log
• With arguments: records the input with a timestamp and appends to the command's log file

Data Storage

All data is stored locally at ~/.local/share/envcheck/. Each action is logged to its own file (e.g., run.log, check.log, analyze.log). A unified history.log tracks all operations. The built-in export function supports JSON, CSV, and plain text formats for backup and portability.

Requirements

• bash 4+ (uses set -euo pipefail)
• Standard Unix utilities (wc, du, grep, tail, sed, date)

When to Use

• Auditing environment configurations and recording check results
• Comparing environment setups across staging, production, and development
• Tracking configuration changes over time with timestamped logs
• Batch processing environment validation tasks
• Exporting environment audit history for compliance or reporting
• Searching past configuration entries by keyword

Examples

# Record a check result
envcheck check ".env has 12 vars, all populated, no duplicates"

# Analyze an environment
envcheck analyze "production .env — 3 vars missing vs template"

# Compare two environments
envcheck compare "staging vs prod — DB_HOST and REDIS_URL differ"

# Generate a config entry
envcheck generate "template .env for microservice with 8 required vars"

# Run a batch validation
envcheck batch "validated 5 .env files across 3 services"

# View recent check entries
envcheck check

# Search for entries about "API_KEY"
envcheck search API_KEY

# Export all data as JSON
envcheck export json

# View summary stats
envcheck stats

# Show recent activity
envcheck recent

# Check overall health
envcheck status

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com