https://github.com/0x80/envi
Capture, store, and restore .env files across your projects with ease
https://github.com/0x80/envi
env git-worktree parallel-agents
Last synced: 13 days ago
JSON representation
Capture, store, and restore .env files across your projects with ease
- Host: GitHub
- URL: https://github.com/0x80/envi
- Owner: 0x80
- License: mit
- Created: 2025-11-01T15:23:32.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-27T12:01:13.000Z (16 days ago)
- Last Synced: 2026-04-27T12:19:20.792Z (16 days ago)
- Topics: env, git-worktree, parallel-agents
- Language: TypeScript
- Homepage: https://envi.codecompose.dev
- Size: 255 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Envi
Environment file management tool - Capture, store, and restore `.env` and `.dev.vars` files across your projects.
[](https://www.npmjs.com/package/@codecompose/envi)
[](LICENSE)
[](https://envi.codecompose.dev)
## Features
- **Centralized Storage** - Capture all `.env` and Cloudflare Workers `.dev.vars` 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
- **At-Rest Encryption** - Optional per-repo encryption key (`envi.maml`) encrypts captured values in storage and the GitHub backup
- **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
```bash
# 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](https://envi.codecompose.dev/getting-started)**
## Documentation
Visit **[envi.codecompose.dev](https://envi.codecompose.dev)** for complete documentation including:
- **[Getting Started](https://envi.codecompose.dev/getting-started)** - Installation and basic usage
- **[Commands](https://envi.codecompose.dev/commands/capture)** - Detailed command documentation
- **[Git Worktrees with AI Tools](https://envi.codecompose.dev/guides/git-worktrees)** - Configure parallel agents
- **[Multi-Language Support](https://envi.codecompose.dev/guides/multi-language-support)** - Using with Rust, Go, Python, and more
- **[GitHub Integration](https://envi.codecompose.dev/guides/github-integration)** - Set up automatic version control
- **[Monorepo Support](https://envi.codecompose.dev/guides/monorepo)** - Working with monorepos
## Commands
- `envi capture` - Capture all .env and .dev.vars files from repository
- `envi restore` - Restore env files from storage
- `envi pack` - Create encrypted blob for sharing with team members
- `envi unpack ` - Decrypt and restore configuration from blob
- `envi create-key` - Generate `envi.maml` to enable at-rest encryption
- `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](https://envi.codecompose.dev/commands/capture)**.
## Development
### Setup
```bash
pnpm install
```
### Build
```bash
pnpm build
```
### Development Mode
```bash
pnpm dev
```
### Testing
```bash
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
```bash
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
```bash
pnpm docs:dev # Start documentation dev server
pnpm docs:build # Build documentation site
pnpm docs:preview # Preview built documentation
```
## License
MIT