teamcity-cli
Agent skill for interacting with TeamCity CI/CD using the teamcity CLI. Enables Claude to explore builds, view logs, start jobs, manage queu
Open source Repository Open in the app JSON README (API)
About
Agent skill for interacting with TeamCity CI/CD using the teamcity CLI. Enables Claude to explore builds, view logs, start jobs, manage queues, agents, and more.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- jetbrains
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 123
- Forks
- 16
- Open pull requests
- 4
- Last push
- 2026-09-09T15:57:52Z
- Repository state
- ativo
- Language
- Go
- License
- Apache-2.0
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-09-11 22:03:19
- Origin id
jetbrains/teamcity-cli/teamcity-cli
README
# TeamCity CLI [](https://github.com/JetBrains) [](https://github.com/JetBrains/teamcity-cli/releases/latest) `teamcity` is the official command-line client for [TeamCity](https://www.jetbrains.com/teamcity/). It covers the day-to-day — starting builds, tailing logs, digging through the queue — and the odd jobs too: shelling into build agents, editing job settings, raw REST calls when nothing else fits.   Full documentation, including installation, authentication, and a command reference, lives at [jb.gg/tc/docs](https://jb.gg/tc/docs). ## Install **macOS (Homebrew):** ```bash brew install jetbrains/utils/teamcity ``` **Linux:** ```bash curl -fsSL https://jb.gg/tc/install | bash ``` **Windows (Winget):** ```powershell winget install JetBrains.TeamCityCLI ``` **npm:** ```bash npm install -g @jetbrains/teamcity-cli ``` <details> <summary>More installation methods (deb, rpm, Chocolatey, Scoop, build from source)</summary> **Debian/Ubuntu:** ```bash curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb sudo dpkg -i teamcity_linux_amd64.deb ``` **RHEL/Fedora:** ```bash sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm ``` **Arch Linux (AUR):** ```bash yay -S teamcity-bin ``` **PowerShell:** ```powershell irm https://jb.gg/tc/install.ps1 | iex ``` **CMD:** ```cmd curl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmd ``` **Chocolatey:** ```powershell choco install teamcitycli ``` **Scoop:** ```powershell scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils scoop install teamcity ``` **Build from source:** ```bash go install github.com/JetBrains/teamcity-cli/tc@latest ``` See the [getting started guide](https://www.jetbrains.com/help/teamcity/teamcity-cli-get-started.html) for the full walkthrough. </details> ## Usage Log in once and the CLI remembers the server: ```bash teamcity auth login ``` Then: ```bash # my latest build on this branch teamcity run list --user @me --branch @this --limit 1 # start a build and stay attached to it teamcity run start MyProject_Build --branch main --watch # logs from the latest build of a job teamcity run log --job MyProject_Build # what's sitting in the queue teamcity queue list # shell into a build agent teamcity agent term Agent-Linux-01 ``` One naming note: TeamCity says *build* and *build configuration*; the CLI says `run` and `job`. The [glossary](https://www.jetbrains.com/help/teamcity/teamcity-cli-glossary.html) has the full mapping. Every command takes `--json` or `--plain` for [scripting](https://www.jetbrains.com/help/teamcity/teamcity-cli-scripting.html), and `--web` opens the matching page in the TeamCity UI. When no command covers what you need, `teamcity api` calls the REST API directly with your stored credentials. You can also log in to several servers and switch between them — see [configuration](https://www.jetbrains.com/help/teamcity/teamcity-cli-configuration.html). ## Commands | Group | Commands | |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **auth** | `login`, `logout`, `status` | | **run** | `list`, `start`, `view`, `watch`, `log`, `tree`, `changes`, `tests`, `diff`, `cancel`, `download`, `artifacts`, `restart`, `pin`/`unpin`, `tag`/`untag`, `comment` | | **job** | `list`, `view`, `create`, `tree`, `pause`/`resume`, `step list`/`view`/`add`/`delete`, `param list`/`get`/`set`/`delete`, `settings list`/`get`/`set` | | **project** | `list`, `view`, `create`, `tree`, `vcs list`/`view`/`create`/`test`/`delete`, `ssh list`/`generate`/`upload`/`delete`, `cloud profile`/`image`/`instance`, `connection list`/`view`/`create github-app`/`create docker`/`authorize`/`delete`, `param`, `token get`/`put`, `settings export`/`status`/`validate` | | **pipeline** | `list`, `view`, `create`, `validate`, `pull`, `push`, `schema`, `delete` | | **queue** | `list`, `approve`, `remove`, `top` | | **agent** | `list`, `view`, `term`, `exec`, `jobs`, `authorize`/`deauthorize`, `enable`/`disable`, `move`, `reboot` | | **pool** | `list`, `view`, `link`/`unlink` | | **server** | `plugin upload` (optionally with `--hot-reload`) | | **api** | Raw REST API access | | **link** | Bind this repository to a TeamCity project via `teamcity.toml` | | **config** | `list`, `get`, `set` | | **alias** | `set`, `list`, `delete` | | **skill** | `list`, `install`, `remove`, `update` | | **update** | Check for CLI updates | Run `teamcity <command> --help` for usage, or see the [command reference](https://www.jetbrains.com/help/teamcity/teamcity-cli-commands.html). ## For AI agents The CLI ships with an [Agent Skill](https://agentskills.io) that teaches coding agents (Claude Code, Cursor, and others) how to drive `teamcity`: ```bash teamcity skill install # auto-detects installed agents teamcity skill install --project # install to current project only teamcity skill update # update to the version bundled with teamcity teamcity skill remove # uninstall ``` or specifically for **Claude Code:** ```bash /plugin marketplace add JetBrains/teamcity-cli /plugin install teamcity-cli@teamcity-cli ``` See [AI agent integration](https://www.jetbrains.com/help/teamcity/teamcity-cli-ai-agent-integration.html) for details. ## Learn more - [Getting started](https://www.jetbrains.com/help/teamcity/teamcity-cli-get-started.html) – install, authenticate, and run your first commands - [Configuration](https://www.jetbrains.com/help/teamcity/teamcity-cli-configuration.html) – config file, environment variables, multi-server setup, shell completion - [Scripting and automation](https://www.jetbrains.com/help/teamcity/teamcity-cli-scripting.html) – JSON output, plain text mode, CI/CD integration - [Aliases](https://www.jetbrains.com/help/teamcity/teamcity-cli-aliases.html) – create custom command shortcuts ## Contributing TeamCity CLI is open source under the Apache-2.0 license. Bug reports and pull requests are welcome — [CONTRIBUTING.md](CONTRIBUTING.md) covers how the project is built and tested.