Skip to main content

​
EnvCP Documentation

Welcome to EnvCP - Secure environment variable management for AI-assisted coding.

​
Quick Navigation

​
Getting Started

​
Platform Guides

​
Advanced Topics

​
Reference

​
What is EnvCP?

EnvCP is a secure environment variable manager designed specifically for AI-assisted coding workflows. It allows AI agents to reference your secrets and environment variables by name without ever seeing the actual values.

​
Key Features

  • Local-only storage - Your secrets never leave your machine
  • AES-256-GCM encryption - Military-grade encryption at rest
  • Reference-based access - AI references variables by name, never sees values
  • Multi-platform support - Works with Claude, ChatGPT, Gemini, local LLMs, and more
  • AI access control - Granular control over what AI can access
  • Session management - Unlock once, work seamlessly
  • Automatic .env sync - Keep your .env files up to date

​
How It Works

  1. You store secrets - Add your API keys, database URLs, and other secrets to EnvCP
  2. AI references by name - When AI needs a secret, it asks for it by variable name
  3. EnvCP handles access - EnvCP checks access rules and provides values only when appropriate
  4. Values stay encrypted - All data is encrypted at rest with your password

​
Why EnvCP?

When working with AI coding assistants, you often need to reference API keys, database credentials, and other secrets. Traditional approaches have problems:
  • Hardcoding secrets - Insecure and easy to accidentally commit
  • Pasting secrets in chat - Exposes them to AI providers and chat logs
  • Manual .env editing - Tedious and error-prone
EnvCP solves these problems by providing a secure, encrypted storage layer that AI can reference without seeing actual values.

​
Quick Start

# Install globally
npm install -g @fentz26/envcp

# Initialize in your project
envcp init

# Add your first secret
envcp add API_KEY --value "your-secret-key"

# Start the server (auto-detects client type)
envcp serve --mode auto --port 3456
For detailed installation instructions, see the Installation Guide.

​
Platform Compatibility

EnvCP works with all major AI platforms:
PlatformSupportProtocol
Claude Desktop✓ NativeMCP
Claude Code✓ NativeMCP
Cursor✓ NativeMCP
Cline (VS Code)✓ NativeMCP
Continue.dev✓ NativeMCP
Zed Editor✓ NativeMCP
ChatGPT✓ Via APIOpenAI Function Calling
GPT-4 API✓ Via APIOpenAI Function Calling
Gemini✓ Via APIGoogle Function Calling
Gemini API✓ Via APIGoogle Function Calling
Local LLMs (Ollama)✓ Via APIREST / OpenAI-compatible
LM Studio✓ Via APIREST / OpenAI-compatible
Open WebUI✓ Via APIREST
Any HTTP Client✓ Via APIREST

​
Support

​
License

EnvCP is open source software licensed under the MIT License.