Agenv — 用于构建、运行和监控 AI 代理的完整 IDE
I’m happy to translate the article for you, but I need the full text of the post in order to do so. Could you please paste the content you’d like translated (excluding the source link, which I’ll keep unchanged)? Once I have the article text, I’ll provide a Simplified Chinese translation while preserving the original formatting and markdown.
概览
Agenv(Agent Development Environment,代理开发环境)是一款专为运行和监控 AI 代理(如 Claude、Gemini、Vertex 或任何基于 CLI 的模型)而打造的全网页 IDE。它提供了一个统一的工作空间,您可以:
- 在分割的终端窗格中并排运行多个代理
- 使用 30 多种语言的语法高亮编辑代码
- 通过内置的 Git 集成进行暂存、差异查看和提交
- 实时跟踪每个会话的 token 使用量和费用
- 持久化会话,能够在浏览器崩溃和重新连接后继续
Agenv 可作为桌面应用(通过 Electron)使用,也可作为 Web 服务器供任何设备访问,包括手机。
Features
- Split terminals – 同时运行多个代理,每个都有独立的持久 PTY 会话。可使用
Alt+1‑9或标签栏切换,并可将文件直接拖拽到终端中。 - Full‑featured file editor – 支持语法高亮、树形视图资源管理器、快速文件搜索(
Ctrl+P)以及项目范围的文本搜索(Ctrl+T)。 - Git sidebar – 可暂存文件、查看差异、编写提交信息并推送,无需离开 IDE。
- Session persistence – 滚动历史、运行中的进程和环境状态在浏览器关闭后仍然保留;数据在磁盘上使用 AES‑256‑GCM 加密。
- Cost monitoring – 实时显示令牌使用量和每个代理会话的费用,并通过状态指示器展示运行中、等待中或出错的状态。
- Security – 桌面模式本地运行且不开放端口;网页模式使用 128 位随机令牌认证、scrypt 哈希密码、速率限制、CSP 头以及 AES‑256‑GCM 加密。
- Lightweight architecture – 采用原生 JavaScript 模块(无 React/Vue),依赖极少,界面响应快速。
安装
# Global install via npm
npm install -g @adibenmatdev/agenv
Or run without installing:
npx @adibenmatdev/agenv
For the optional desktop app experience, install Electron globally:
npm install -g electron
快速开始
# Launch the environment (desktop app if Electron is installed, otherwise web mode)
agenv
# Force web mode (opens in browser, accessible from any device)
agenv --web
# Web mode on a custom port
agenv --web --port 8080
# Launch directly into an agent (example with Claude)
agenv run claude --model
使用说明
运行多个代理
每个代理都在其独立的持久化 PTY 会话中运行。使用 Alt+1‑9 或标签栏在它们之间切换。即使关闭浏览器或关闭笔记本电脑,会话仍会保留滚动历史和正在运行的进程。
编辑文件
内置编辑器支持 30 多种语言的语法高亮、树形视图文件资源管理器、快速文件搜索(Ctrl+P)以及项目范围的文本搜索(Ctrl+T)。无需在终端和外部编辑器之间切换。
Git 集成
在侧边栏中,你可以:
- 暂存和取消暂存文件
- 查看差异
- 编写提交信息
- 推送到远程仓库
这满足了大多数会话期间的版本控制需求,无需离开 IDE。
会话持久化与安全
- 所有会话数据均使用 AES‑256‑GCM 加密存储。
- 桌面模式本地运行,不打开网络端口。
- Web 模式使用 128 位随机令牌进行身份验证,密码采用 scrypt 哈希,具备速率限制和严格的 CSP 头部。
成本监控
实时显示每个代理会话的令牌使用量和费用,帮助你避免意外的计费惊喜。
桌面模式 vs. Web 模式
# 桌面模式(当 Electron 可用时默认)
agenv
# Web 模式 – 可从网络中的任意设备访问
agenv --web --host 0.0.0.0
# 通过内置 ngrok 集成进行远程访问(在 UI 中启用)
agenv --web
架构
Agenv 将技术栈保持在最小化:
- express – HTTP 服务器
- ws – WebSocket 通信
- @lydell/node-pty – 终端仿真
- qrcode-terminal – 为移动访问生成二维码
前端由普通的 JavaScript 模块组成——无需 React、Vue,也不需要构建步骤。
许可证与链接
- GitHub:
- npm 包:
@adibenmatdev/agenv - 许可证: Apache‑2.0
如果您正在使用 AI 代理进行构建,请尝试一下 Agenv。欢迎提交问题、拉取请求和点赞。