Skillget

teamcity-cli

agent
Security Audit
Fail
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 69 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in .teamcity.yml
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is an official command-line interface and AI agent tool for JetBrains TeamCity. It allows users to trigger builds, stream real-time logs, manage build queues, and access remote agent terminals directly from the command line or integrated AI assistants.

Security Assessment
The tool inherently makes external network requests to communicate with your TeamCity servers. It provides features to execute remote shell commands on build agents, which poses a significant risk if the tool is exposed to malicious prompts or unauthorized users. The automated audit raised a flag for a recursive force deletion command (`rm -rf`) located inside a configuration file (`.teamcity.yml`). While common in CI/CD environments for cleaning up workspaces, this execution path should be inspected to ensure it is not misused or triggered inadvertently. Overall risk: Medium.

Quality Assessment
The project is exceptionally well maintained, having received updates as recently as today. It is backed by JetBrains, a highly trusted vendor in the software development ecosystem, and uses the permissive Apache-2.0 license. The repository has a modest but solid community following. It does not request any inherently dangerous local permissions, adding to its reliability.

Verdict
Safe to use, provided you trust the underlying CI/CD environment and carefully manage AI agent permissions when utilizing the remote agent terminal features.
SUMMARY

TeamCity from your terminal – or your AI's. Builds, logs, agents, agent terminals, queues.

README.md

TeamCity CLI


GitHub Release

TeamCity CLI (teamcity) is an open-source command-line interface for TeamCity. Start builds, tail logs, manage agents and queues – without leaving your terminal.

Documentation – full guide with installation, authentication, and command reference.

cli
cli

Features

  • Stay in your terminal – Start builds, view logs, manage queues – no browser needed
  • Remote agent access – Shell into any build agent with teamcity agent term, or run commands with teamcity agent exec
  • Real-time logs – Stream build output as it happens with teamcity run watch --logs
  • Scriptable – --json and --plain output for pipelines, plus direct REST API access via teamcity api
  • Multi-server support – Authenticate with and switch between multiple TeamCity instances
  • AI agent ready – Built-in skill for Claude Code, Cursor, and other AI coding agents – just run teamcity skill install

Installation

macOS (Homebrew):

brew install jetbrains/utils/teamcity

Linux:

curl -fsSL https://jb.gg/tc/install | bash

Windows (Winget):

winget install JetBrains.TeamCityCLI

npm:

npm install -g @jetbrains/teamcity-cli
More installation methods (deb, rpm, Chocolatey, Scoop, build from source)

Debian/Ubuntu:

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb
sudo dpkg -i teamcity_linux_amd64.deb

RHEL/Fedora:

sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm

Arch Linux (AUR):

yay -S teamcity-bin

PowerShell:

irm https://jb.gg/tc/install.ps1 | iex

CMD:

curl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmd

Chocolatey:

choco install teamcitycli

Scoop:

scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils
scoop install teamcity

Build from source:

go install github.com/JetBrains/teamcity-cli/tc@latest

See the getting started guide for the full walkthrough.

Quick start

# Authenticate with your TeamCity server
teamcity auth login

# List recent builds
teamcity run list --limit 10

# List your favorite builds
teamcity run list --favorites --limit 10

# List my latest build for the current branch
teamcity run list --user @me --branch @this --limit 1

# Start a build and watch it run
teamcity run start MyProject_Build --branch main --watch

# View logs from the latest build of a job
teamcity run log --job MyProject_Build

# Check what's in the queue
teamcity queue list

Note: The CLI uses "run" for builds and "job" for build configurations. See the glossary for the full mapping.

Commands

Group Commands
auth login, logout, status
run list, start, view, watch, log, changes, tests, cancel, download, artifacts, restart, pin/unpin, tag/untag, comment
job list, view, tree, pause/resume, param list/get/set/delete
project list, view, tree, vcs list/view/create/delete, param, token get/put, settings export/status/validate
queue list, approve, remove, top
agent list, view, term, exec, jobs, authorize/deauthorize, enable/disable, move, reboot
pool list, view, link/unlink
api Raw REST API access
config list, get, set
alias set, list, delete
skill install, remove, update

Run teamcity <command> --help for usage details. See the command reference for full documentation.

For AI agents

An Agent Skill is included with teamcity. It teaches AI coding agents how to use teamcity for common TeamCity workflows.

teamcity skill install           # auto-detects installed agents (Claude Code, Cursor, etc.)
teamcity skill install --project # install to current project only
teamcity skill update            # update to latest version bundled with teamcity
teamcity skill remove            # uninstall

or specifically for Claude Code:

/plugin marketplace add JetBrains/teamcity-cli
/plugin install teamcity-cli@teamcity-cli

See AI agent integration for details.

Learn more

Contributing

TeamCity CLI is open source under the Apache-2.0 license. Contributions are welcome – see CONTRIBUTING.md for setup instructions and guidelines.

License

Apache-2.0

Reviews (0)

No results found