命令行工具
yuxi-cli 是 Yuxi 的命令行客户端，适合在本地脚本或终端中管理远程实例、登录账号、上传知识库文件，以及运行部分智能体任务。
安装
推荐使用 uv 或 pipx 安装：
bash
uv tool install yuxi-cli也可以临时运行：
bash
uvx --from yuxi-cli yuxi --help安装后可通过 yuxi --version 查看当前版本。
配置远程实例
先添加一个 Yuxi 实例地址，再设为当前默认 remote：
bash
yuxi remote add local http://localhost:5173
yuxi remote use local
yuxi remote ping配置会保存在 ~/.yuxi/config.toml。如果需要同时管理多个实例，可以继续添加其他 remote，并通过 yuxi remote use <name> 切换。
登录
默认使用浏览器授权登录：
bash
yuxi login --browser如果已经在 Yuxi 中创建了 API Key，也可以直接导入：
bash
yuxi login --api-key yxkey_xxx常用账号状态命令：
bash
yuxi whoami
yuxi status
yuxi logout上传知识库文件
上传目录时，如果不指定 --kb-id，CLI 会拉取当前 remote 中可用的知识库并在终端中选择：
bash
yuxi kb upload ./docs默认会选择常见文本和 Office 文档类型，可在预览阶段调整文件类型；也可以通过参数直接指定：
bash
yuxi kb upload ./docs --kb-id kb_xxx --concurrency 4
yuxi kb upload ./docs --include-ext md,html,docxCLI 会让每个并发单元完成单个文件的上传和文档记录添加，--concurrency 默认 10，允许范围 1-300，用于控制同时处理的文件数。上传会保留目录中的相对路径，便于在知识库文件列表中按原目录结构查看。
运行智能体评估
如果实例已配置 Langfuse 数据集，可以用 CLI 触发智能体评估：
bash
yuxi agent eval \
--dataset-name demo-dataset \
--agent-slug default-agent \
--experiment-name cli-demo该命令会读取 Langfuse 数据集输入，调用 Yuxi 智能体运行，并把结果回传到对应实验中。