新增功能

标题概述了 UiPath CLI 重写中的更改，涵盖新的 Runtime、命令模型以及与旧版.NET CLI 的主要差异。

UiPath CLI 是从头开始重写的命令行工具，用于替换 通过2025.10使用的uipcli.exe .NET 工具。如果您要从 2025.10 管道迁移，请阅读迁移指南— 本页面是更改内容及其原因的标题摘要。

其他工具

UiPath CLI is a TypeScript CLI distributed on npm as @uipath/cli and invoked as uip. It runs on Node.js 22+ on Windows, macOS, and Linux. The host and most tools have no .NET dependency; the rpa-tool is the exception — it wraps the Studio packager and the workflow compiler, both of which still require a .NET runtime. Install the host the same way in every environment:

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. Skills are published by UiPath and installed per-agent. Once installed, the agent can drive a full pack-publish-deploy flow without requiring you to type each command. See Using UiPath CLI with 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 。

有关完整更改列表以及之后发布的任何内容，请参阅发行说明。