Envless：Agent 时代的密钥管理——干掉 .env 文件，内置 MCP Server 让 Agent 自己取密钥

📝

Envless 是一个用 Zig 写的开源密钥管理工具——age+sops 加密、.envless/ 目录天然 gitignore、exec 注入、内置 MCP Server 让 AI Agent 安全读写密钥。v0.0.1 早期项目，2⭐，Apache-2.0。

数据来源：小红书笔记（一目烟）+ GitHub README 实测核对（2026-08-07）。项目地址：https://github.com/biliboss/envless

Envless 是一个用 Zig 写的开源密钥管理工具——你不再需要 .env 文件，不再需要服务器，不再需要 Vault。一条命令存密钥，一条命令注入运行，process.env 照用不误。定位是 Agent 时代的密钥基础设施。

传统模式 vs Envless

❌ 以前	✅ 现在
.env 文件明文存密钥	age+sops 加密存储
容易误提交到 Git	`.envless/` 目录天然 gitignore
换机器要手动拷贝	identity key 即身份，随走随用
泄露了才知道出事	exec 注入，应用无感知切换

核心架构

envless init          → 生成 identity.key + recipients
envless set KEY       → age 公钥加密 → sops 写入 secrets/*.env.enc
envless exec -- CMD   → sops 解密 → 注入 process.env → fork 子进程
envless mcp           → MCP Server（JSON-RPC 2.0 over stdio）→ AI Agent 直接读写密钥

六大亮点

⚡ Zig 编写：单二进制 ~150KB，交叉编译 4 平台（linux/macos × x86_64/aarch64）
🔒 age + sops 加密：密钥只有 identity.key 持有者能解
🤖 内置 MCP Server：AI Agent 通过 JSON-RPC 安全读写密钥，全程无人介入
🌍 多环境支持：--env=dev / staging / prod，密钥天然隔离
💾 自动备份：tar.gz 打包加密文件，identity key 安全排除
🚀 一键迁移：envless migrate .env → 加密存储，原文件删除，gitignore 自动更新

MCP Server（v0.0.1 已落地）

子命令 envless mcp，JSON-RPC 2.0 over stdio，MCP 协议 2024-11-05
8 个工具：envs list get set exec init migrate whoami
get 强制 confirm:true——读取密钥需要显式确认，防止 Agent 悄悄读走
exec 硬 300 秒超时，stdout/stderr 各 16MiB 上限
可选 daemon 加速（UNIX-socket 解密缓存）

快速上手

# 安装（macOS / Linux）
brew tap biliboss/envless https://github.com/biliboss/envless
brew install biliboss/envless/envless

# 初始化 + 存密钥
cd ~/your-project
envless init
echo "sk-xxx" | envless set OPENAI_API_KEY

# 注入运行
envless exec -- node server.js
# process.env.OPENAI_API_KEY 已就绪 ✅

# 迁移已有 .env
envless migrate .env   # 加密 → secrets/dev.env.enc → 删除 .env → 更新 .gitignore

⚠️ 实测核对（笔记 vs GitHub）

项目	笔记说法	GitHub 实测	判定
Star	未提	2⭐（2026-05-21 创建）	早期项目
Zig 版本	0.16.0	0.13.0（pinned）	⚠️ 矛盾
零运行时依赖	是	需 age>=1.2 + sops>=3.9（brew 自动拉）	⚠️ 不准确
MCP Server	内置	✅ 属实（8 工具）	✅
单二进制 150KB	是	✅ 属实	✅

状态：v0.0.1 — single-user core works；Teams + plugins + skill 在 v0.1。README 明示早期阶段。

为什么值得关注

传统密钥管理：人写 .env → 应用读取 → 容易泄露。
Envless 的链路：Agent → MCP → 加密密钥 → 安全注入。

当你用 Claude Code、Cursor、Copilot 写代码时，Agent 需要读取 API Key、数据库密码等敏感信息——Envless 让这个过程既自动化又安全，且全程无服务器、密钥只在你手里。

⚠️ 注意：项目处于 v0.0.1（2⭐），生产使用需谨慎；密钥存储方案建议评估 age/sops 生态成熟度后再决策。