TeamCity CLI (teamcity)
Quick Start
teamcity auth status # Check authentication
teamcity run list --status failure # Find failed builds
teamcity run log <id> --failed # Full failure diagnostics
Do not guess flags or syntax. Use the Command Reference or teamcity <command> --help. Fall back to teamcity api /app/rest/... when needed. Builds are runs (teamcity run), build configurations are jobs (teamcity job).
Core Commands
| Area | Commands |
|---|---|
| Builds | run list, view, start, watch, log, cancel, restart, tests, changes |
| Artifacts | run artifacts, run download |
| Metadata | run pin/unpin, run tag/untag, run comment |
| Jobs | job list, view, tree, pause/resume, param list/get/set/delete |
| Projects | project list, view, tree, param, token put/get, settings export/status/validate |
| Queue | queue list, approve, remove, top |
| Agents | agent list, view, enable/disable, authorize/deauthorize, exec, term, reboot, move |
| Pools | pool list, view, link/unlink |
| API | teamcity api <endpoint> — raw REST API access |
Quick Workflows
Investigate failure: teamcity run list --status failure → teamcity run log <id> --failed → teamcity run tests <id> --failed
From a URL: Extract build ID from https://host/buildConfiguration/ConfigId/12345 → teamcity run view 12345
Start build: teamcity run start <job-id> --branch <branch> --watch
Find jobs: teamcity project list → teamcity job list --project <id>
References
- Command Reference - All commands and flags
- Workflows - URL handling, failure investigation, artifacts, agents, and more
- Output Formats - JSON, plain text, scripting