{
"markdown": "# TeamCity CLI\n\n[](https://github.com/JetBrains)\n[](https://github.com/JetBrains/teamcity-cli/releases/latest)\n\n`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.\n\n\n\n\nFull documentation, including installation, authentication, and a command reference, lives at [jb.gg/tc/docs](https://jb.gg/tc/docs).\n\n## Install\n\n**macOS (Homebrew):**\n```bash\nbrew install jetbrains/utils/teamcity\n```\n\n**Linux:**\n```bash\ncurl -fsSL https://jb.gg/tc/install | bash\n```\n\n**Windows (Winget):**\n```powershell\nwinget install JetBrains.TeamCityCLI\n```\n\n**npm:**\n```bash\nnpm install -g @jetbrains/teamcity-cli\n```\n\n\nMore installation methods (deb, rpm, Chocolatey, Scoop, build from source)
\n\n**Debian/Ubuntu:**\n```bash\ncurl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb\nsudo dpkg -i teamcity_linux_amd64.deb\n```\n\n**RHEL/Fedora:**\n```bash\nsudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm\n```\n\n**Arch Linux (AUR):**\n```bash\nyay -S teamcity-bin\n```\n\n**PowerShell:**\n```powershell\nirm https://jb.gg/tc/install.ps1 | iex\n```\n\n**CMD:**\n```cmd\ncurl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmd\n```\n\n**Chocolatey:**\n```powershell\nchoco install teamcitycli\n```\n\n**Scoop:**\n```powershell\nscoop bucket add jetbrains https://github.com/JetBrains/scoop-utils\nscoop install teamcity\n```\n\n**Build from source:**\n```bash\ngo install github.com/JetBrains/teamcity-cli/tc@latest\n```\n\nSee the [getting started guide](https://www.jetbrains.com/help/teamcity/teamcity-cli-get-started.html) for the full walkthrough.\n\n \n\n## Usage\n\nLog in once and the CLI remembers the server:\n\n```bash\nteamcity auth login\n```\n\nThen:\n\n```bash\n# my latest build on this branch\nteamcity run list --user @me --branch @this --limit 1\n\n# start a build and stay attached to it\nteamcity run start MyProject_Build --branch main --watch\n\n# logs from the latest build of a job\nteamcity run log --job MyProject_Build\n\n# what's sitting in the queue\nteamcity queue list\n\n# shell into a build agent\nteamcity agent term Agent-Linux-01\n```\n\nOne 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.\n\nEvery 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).\n\n## Commands\n\n| Group | Commands |\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **auth** | `login`, `logout`, `status` |\n| **run** | `list`, `start`, `view`, `watch`, `log`, `tree`, `changes`, `tests`, `diff`, `cancel`, `download`, `artifacts`, `restart`, `pin`/`unpin`, `tag`/`untag`, `comment` |\n| **job** | `list`, `view`, `create`, `tree`, `pause`/`resume`, `step list`/`view`/`add`/`delete`, `param list`/`get`/`set`/`delete`, `settings list`/`get`/`set` |\n| **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` |\n| **pipeline** | `list`, `view`, `create`, `validate`, `pull`, `push`, `schema`, `delete` |\n| **queue** | `list`, `approve`, `remove`, `top` |\n| **agent** | `list`, `view`, `term`, `exec`, `jobs`, `authorize`/`deauthorize`, `enable`/`disable`, `move`, `reboot` |\n| **pool** | `list`, `view`, `link`/`unlink` |\n| **server** | `plugin upload` (optionally with `--hot-reload`) |\n| **api** | Raw REST API access |\n| **link** | Bind this repository to a TeamCity project via `teamcity.toml` |\n| **config** | `list`, `get`, `set` |\n| **alias** | `set`, `list`, `delete` |\n| **skill** | `list`, `install`, `remove`, `update` |\n| **update** | Check for CLI updates |\n\nRun `teamcity --help` for usage, or see the [command reference](https://www.jetbrains.com/help/teamcity/teamcity-cli-commands.html).\n\n## For AI agents\n\nThe CLI ships with an [Agent Skill](https://agentskills.io) that teaches coding agents (Claude Code, Cursor, and others) how to drive `teamcity`:\n\n```bash\nteamcity skill install # auto-detects installed agents\nteamcity skill install --project # install to current project only\nteamcity skill update # update to the version bundled with teamcity\nteamcity skill remove # uninstall\n```\n\nor specifically for **Claude Code:**\n```bash\n/plugin marketplace add JetBrains/teamcity-cli\n/plugin install teamcity-cli@teamcity-cli\n```\n\nSee [AI agent integration](https://www.jetbrains.com/help/teamcity/teamcity-cli-ai-agent-integration.html) for details.\n\n## Learn more\n\n- [Getting started](https://www.jetbrains.com/help/teamcity/teamcity-cli-get-started.html) – install, authenticate, and run your first commands\n- [Configuration](https://www.jetbrains.com/help/teamcity/teamcity-cli-configuration.html) – config file, environment variables, multi-server setup, shell completion\n- [Scripting and automation](https://www.jetbrains.com/help/teamcity/teamcity-cli-scripting.html) – JSON output, plain text mode, CI/CD integration\n- [Aliases](https://www.jetbrains.com/help/teamcity/teamcity-cli-aliases.html) – create custom command shortcuts\n\n## Contributing\n\nTeamCity 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.\n",
"bytes": 10570,
"sha": "0b10a9bcfda6d474cdf2e2ea314baeab8a3ed026ff07e8aaccf5e48d6130b424",
"repo_slug": "jetbrains/teamcity-cli",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_jetbrains_teamcity_cli_teamcity_cli_42beaf8a/readme"
}