teamcity-cli

JetBrains官方出品的TeamCity命令行客户端,用于自动化CI/CD流程。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:teamcity-cli。
它的用途是:JetBrains官方出品的TeamCity命令行客户端,用于自动化CI/CD流程。
完整的 Skill 内容见:https://321skill.com/skills/teamcity-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我用TeamCity CLI启动main分支上的MyProject_Build任务,并实时关注日志。’ 它会生成命令 `teamcity run start MyProject_Build --branch main --watch`,并解释该命令会启动构建并保持连接,实时输出日志流。或者,你可以问:‘如何查看我最近的构建?’ 它会提供 `teamcity run list --user @me --branch @this --limit 1` 命令来列出当前用户在当前分支上的最新一次构建。

介绍

TeamCity CLI是JetBrains官方为TeamCity持续集成服务器开发的命令行工具,旨在将TeamCity的核心功能从Web界面延伸到终端。它解决了开发者和运维人员在命令行中直接、高效地管理CI/CD流程的需求,无需频繁切换至浏览器。

使用上,用户通过简单的命令即可完成日常操作,例如启动构建、实时查看构建日志、管理构建队列、甚至通过SSH连接到构建代理服务器。工具支持多种安装方式,并通过teamcity auth login命令一键登录,之后会记住服务器配置,简化了后续操作。

该工具非常适合频繁与TeamCity交互的DevOps工程师、后端开发者和系统管理员,特别是那些习惯在终端工作、追求自动化脚本或需要将CI/CD流程集成到其他工具链中的专业人士。

与同类CI/CD命令行工具相比,TeamCity CLI的最大优势在于其官方血统,确保了与TeamCity服务器API的深度、稳定和最新兼容性,并且其命令设计紧密贴合TeamCity自身的概念体系(如将‘构建配置’映射为job),学习成本更低。

核心特点

作为JetBrains官方出品,它与TeamCity服务器的API兼容性最好、功能覆盖最全,且更新同步。其命令设计(如`run`对应构建)直接映射TeamCity核心概念,降低了用户的理解和使用门槛。

注意事项

该工具专为TeamCity设计,不适用于其他CI/CD平台(如Jenkins、GitLab CI)。

常见问题

TeamCity CLI能做什么?

可以启动构建、查看日志、管理队列、连接构建代理,并通过`teamcity api`直接调用REST API。

如何安装TeamCity CLI?

支持多种方式,如macOS用Homebrew (`brew install jetbrains/utils/teamcity`),Linux用curl脚本,Windows可用Winget或Scoop。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/teamcity-cli/raw/index.md 读取 teamcity-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。