Install EVA-CLI

推荐用 npm 全局安装

当前版本 0.0.0。请使用 npm 安装 scoped 包，不要使用 bun install -g；Bun 全局安装 @eva/cli 存在依赖循环问题。

安装命令

$ npm install -g @eva/cli --registry=https://npm.0ldm0s.net

Quick Start

安装、验证、启动

# 1. 全局安装
$ npm install -g @eva/cli --registry=https://npm.0ldm0s.net

# 2. 验证安装
$ eva --version

# 3. 启动 EVA-CLI
$ eva

# 4. 配置 Provider 与 API 密钥
$ /providers
$ /eva-key

Linux x64 CPU 用户

安装后 postinstall 会自动检测并以 CPU 模式完成 onnxruntime-node 配置。如仍有问题可使用 ONNXRUNTIME_NODE_INSTALL=skip 手动跳过。

首次启动

首次交互运行时会显示工作区信任提示。确认后即可进入 EVA 的中文终端体验。

Offline Package

离线分发 .tgz 包

适合内网环境、镜像环境或需要固定产物的发布流程。

# 构建 npm 包
$ bash scripts/build-prod.sh && bash scripts/package-npm.sh

# 使用生成的 .tgz 安装
$ npm install -g eva-cli-*.tgz

# 验证
$ eva --version

Build From Source

从源码构建

源码构建依赖

build-essential / python3
node-gyp
Bun 用于开发依赖安装

原生模块

node-pty：终端仿真
better-sqlite3：记忆持久化
@biomejs/biome：检查与格式化

# 1. 安装编译工具
$ sudo apt install -y build-essential python3
$ bun add -g node-gyp

# 2. 安装依赖
$ bun install --registry https://registry.npmmirror.com

# 3. 编译原生模块
$ node-gyp rebuild --directory=node_modules/node-pty
$ node-gyp rebuild --directory=node_modules/better-sqlite3
$ cd node_modules/@biomejs/biome && node scripts/postinstall.js

# 4. 构建并全局安装
$ cd ../..
$ npm run build
$ npm install -g .
$ eva --version

Long Running

长时间运行建议

EVA-CLI 适合自动化巡检、Agent 报告和长任务。README 建议使用 --expose-gc，让 compaction 后可以主动触发垃圾回收，降低长时间运行后的 RSS 增长。

node --expose-gc dist/entrypoints/cli.mjs

Multi-Agent

并发子 Agent 权限

异步子 Agent 不能弹出权限确认框。多 Agent 并发任务建议在 ~/.claude/settings.json 中提前允许 Read、Glob、Grep 等只读工具范围。

Read(src/**) · Glob(src/**) · Grep(src/**)