Envi

Environment file management tool - Capture, store, and restore .env files across your projects.

Features

• Centralized Storage - Capture all .env files into a central, version-controlled location
• Easy Restoration - Restore env files on new systems or git worktrees when working with parallel AI agents
• Secure Sharing - Share configurations safely with team members using encrypted, compressed blobs
• GitHub Integration - Optional automatic version control
• Comment Preservation - Keeps full-line and inline comments
• Monorepo Support - Works seamlessly with monorepos
• 100% Test Coverage - Core logic (encryption, parsing, storage) fully tested

Quick Start

# Install globally
pnpm add -g @codecompose/envi

# Capture env files
cd /path/to/your/project
envi capture

# Restore env files
envi restore

→ Full Installation Guide

Documentation

Visit envi.codecompose.dev for complete documentation including:

• Getting Started - Installation and basic usage
• Commands - Detailed command documentation
• Git Worktrees with AI Tools - Configure parallel agents
• Multi-Language Support - Using with Rust, Go, Python, and more
• GitHub Integration - Set up automatic version control
• Monorepo Support - Working with monorepos

Commands

• envi capture - Capture all .env files from repository
• envi restore - Restore env files from storage
• envi pack - Create encrypted blob for sharing with team members
• envi unpack <blob> - Decrypt and restore configuration from blob
• envi clear - Delete stored configuration for current project
• envi global github enable - Enable GitHub version control
• envi global github disable - Disable GitHub version control
• envi global github restore - Restore envi store from GitHub
• envi global clear - Delete entire envi directory and all stored configurations

Run any command with --help for more information or see the Commands documentation.

Development

Setup

pnpm install

Build

pnpm build

Development Mode

pnpm dev

Testing

pnpm test              # Run tests
pnpm test:ui           # Run tests with UI
pnpm test:coverage     # Run tests with coverage

Test Coverage: Core business logic (encryption, compression, parsing, storage) has 100% test coverage.

Linting & Formatting

pnpm lint              # Run linter
pnpm lint:fix          # Run linter and fix issues
pnpm format            # Format code with Prettier
pnpm check-format      # Check if code is formatted
pnpm check-types       # Run TypeScript type checking

Documentation

pnpm docs:dev          # Start documentation dev server
pnpm docs:build        # Build documentation site
pnpm docs:preview      # Preview built documentation

License

MIT