标题概述了 UiPath CLI 重写中的更改，涵盖新的 Runtime、命令模型以及与旧版.NET CLI 的主要差异。
UiPath CLI 是从头开始重写的命令行工具，用于替换 通过2025.10使用的uipcli.exe .NET 工具。如果您要从 2025.10 管道迁移，请阅读迁移指南— 本页面是更改内容及其原因的标题摘要。
其他工具
UiPath CLI 是在npm上分发的TypeScript CLI ，名称为@uipath/cli ，并作为uip进行调用。它可以在 Windows、macOS 和 Linux 上的 Node.js 22+ 版本上运行。主机和大多数工具没有.NET 依赖项； rpa-tool是一个例外，它包含 Studio 打包程序和工作流编译器，而两者仍然需要.NET Runtime。在每个环境中以相同的方式安装主机：
npm install -g @uipath/cli
npm install -g @uipath/cli
CLI 是一个插件主机。每个 UiPath 界面（Orchestrator、解决方案、智能体、流、Maestro、Test Manager 等）的命令作为单独的 npm 包提供，这些包uip会在您首次使用时自动安装。请参阅工具（插件） 。
语义版本控制
基于日历的版本控制（2023.10、2024.10、2025.10）已不复存在。从第一个预览版 1.197.0 开始应用语义版本控制标记为“正式发布” ：
- 主要— 首先是具有完整弃用周期的重大更改。
- Minor — 新命令、新标志，仅限叠加。
Data形状可以演变。 - PATCH — 仅修复错误。
主机和工具版本坐标：每个工具默认跟踪 CLI 的 MAJOR.MINOR 行。请参阅版本控制和稳定性。
不仅仅是 CI/CD
旧版 CLI 是一个 CI/CD 工具：打包、分析、部署、运行测试。UiPath CLI 1.x 涵盖完整平台（构建、管理、运营、部署），专为开发者以交互方式使用以及管道以编程方式使用而设计。您现在可以：
- 构建并验证项目（
uip solution init、uip agent init、uip maestro flow init和uip maestro bpmn init）。 - 管理 Orchestrator 资源（文件夹、流程、包、计算机、用户、角色、许可证、队列、资产、存储桶、Webhook）。
- 启动和监控作业（
uip or jobs start、uip or jobs get），使用可选的--wait-for-completion。 - 推动包括评估在内的整个智能体生命周期 (
uip agent eval)。 - 检查流和 Maestro 实例和事件。
- 管理 Data Fabric 实体和 Integration Service 连接。
每个命令都返回相同的结构化 JSON 信封，因此您可以手动执行的任何操作都可以编写脚本。
默认为 JSON
默认情况下，标准输出上为 JSON 输出，并具有稳定的信封（ Result 、 Code 、 Data 、 Message 、 Instructions ）。人类通过--output table选择加入表格视图；管道和 AI 智能体无需额外标记即可获取干净的结构化数据。请参阅输出格式。
人性化交互式登录
uip login将打开浏览器，为您登录 UiPath，并将刷新的会话保留在~/.uipath/中。不再需要将客户端凭据嵌入到开发者工作站上。CI 管道仍使用外部应用程序客户端凭据（现在通过--client-id env.UIPATH_CLIENT_ID传递），并且容器可以通过不透明的访问令牌使用环境变量身份验证。请参阅身份验证。
专为 AI 编码智能体构建
The uip skills system teaches ten supported coding agents — Claude Code, Cursor, GitHub Copilot, Codex, OpenCode, UiPath Autopilot, Kiro (Amazon Q), Windsurf, Antigravity CLI, and Devin — how to use uip. 技能由 UiPath 发布，并根据智能体安装。安装后，智能体可以驱动完整的“打包-发布-部署”流程，而无需您键入每个命令。请参阅将 UiPath CLI 与 Coding Agents 一起使用。
Shell 补全
uip completion为 bash、zsh、false 和 PowerShell 安装 Tab 键补全。当jq位于路径中时，动态标志值补全（例如uip or packages upload --package-name <TAB> ）可在 zsh 上使用；静态子命令和选项名称补全适用于所有四种 shell。
其他有意义的转变
- 不会读取隐式 env-var 身份验证操作。系统不再自动读取
UIPATH_CLIENT_ID和UIPATH_CLIENT_SECRET。通过--client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET传递（env.前缀在运行时查找变量，而不在命令行中公开）。 - 退出代码已收紧为五个值（0/1/2/3/4，加上 130 用于用户取消）。合同在主要版本中稳定——脚本针对他们。请参阅退出代码。
- 在解析时，对每个命令进行JMESPath 筛选(
--output-filter)，出现语法错误时退出代码3这样即使输入错误也不会浪费 API 调用。 - 跨平台。支持 ARM64 Windows、macOS 和 Linux — 反映了 Node.js 运行时。
- 遥测选择退出变量从
UIPATH_EXTENSIONS_CLI_TELEMETRY_ENABLED=False重命名为UIPATH_TELEMETRY_DISABLED=1。默认情况下，两代都是选择退出的——更新依赖旧名称的 CI 运行器。
从哪里开始
- 新用户?快速入门。
- 是否要从 2025.10 版本迁移？迁移指南。
- 正在设置 CI？您的第一个管道→ 选择CI/CD 模式。
- 使用 AI 智能体？结合使用 UiPath CLI 和 Coding Agents 。
有关完整更改列表以及之后发布的任何内容，请参阅发行说明。