TeamCity コマンドラインインターフェース

TeamCity CLI は TeamCity の公式コマンドラインインターフェースです。ターミナルで「teamcity 」と入力すると、ビルドの開始、ログの追跡、エージェントとキューの管理などが行えます。

機能

ターミナル内で作業を続行 — ビルドを開始し、ログを表示し、キューを管理できます — ブラウザーは不要です。
リモートエージェントアクセス — teamcity agent term を使用して任意のビルドエージェントにシェル接続するか、 teamcity agent exec を使用してコマンドを実行します。
リアルタイムログ — teamcity run watch --logs で発生したビルド出力をストリームします。
スクリプト化可能 — パイプライン向けの --json と --plain 出力に加え、 teamcity api 経由で REST API に直接アクセスできます。
マルチサーバー対応 — 複数の TeamCity インスタンスで認証し、切り替えられます。
AI エージェント対応 — Claude Code、Cursor、その他の AI コーディングエージェント用の組み込みスキル (英語) - teamcity skill install を実行するだけです。

TeamCity CLI のインストール

Homebrew (推奨)：

brew install jetbrains/utils/teamcity

インストールスクリプト：

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

Winget (推奨)：

winget install JetBrains.TeamCityCLI

PowerShell (インストールスクリプト)：

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

npm (クロスプラットフォーム)：

npm install -g @jetbrains/teamcity-cli

その他の方法 (Scoop、Chocolatey、deb/rpm パッケージ、ソースからのビルド) については、スタートガイドを参照してください。

クイックスタート

# Authenticate with your TeamCity server
teamcity auth login

# List recent builds
teamcity run list --limit 10

# 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

  

詳しい手順については、 TeamCity CLI 入門を参照してください。

できること

トピック	説明
入門	インストール、認証、最初のコマンドを実行する
認証	トークンの保存、ゲストアクセス、マルチサーバーのセットアップ、CI/CD の使用
構成	設定ファイル、環境変数、シェル補完
リポジトリのリンク	`teamcity.toml` 経由でリポジトリ (またはモノリポのサブディレクトリ) を TeamCity プロジェクトにバインドします
実行の管理	ビルドの開始、監視、管理
パイプラインの管理	`.teamcity.yml` パイプラインの作成、検証、同期
ジョブの管理	ビルド構成の表示と構成
プロジェクトの管理	プロジェクトを閲覧し、VCS ルート、パラメーター、バージョン管理設定を管理します。
ビルドキューの管理	キューに入れられたビルドをインスペクションし、優先順位を制御し、ビルドを承認する
エージェントの管理	ビルドエージェントをリモートで監視、制御、アクセスする
エージェントプールの管理	プロジェクトとエージェントをプールに割り当てる
クラウドエージェントの管理	クラウドプロファイル、イメージ、一時的なエージェントインスタンスを管理します。
REST API アクセス	コマンドラインから認証された API リクエストを行う
エイリアス	カスタムコマンドショートカットを作成する
スクリプティングと自動化	JSON 出力、プレーンテキストモード、CI/CD 統合
コマンドリファレンス	利用可能なすべてのコマンドとフラグのクイックリファレンス
AI エージェント統合	AI コーディングエージェント用の TeamCity スキルをインストールする
用語集	CLI 用語の定義と TeamCity の概念への対応
匿名の使用箇所の統計	CLI が JetBrains に送信する内容とオプトアウト方法

2026 年 9 月 11 日