TeamCity Companion

Your mobile companion app for TeamCity


Why a mobile app?

TeamCity Companion is the premier iOS app to review and manage your Continuous Integration builds on the go. While TeamCity is a great and easy to use CI server, keeping up with your builds is not as easy as it could be.

TeamCity Companion provides a native user interface optimized for easy consumption, enabling you to review build progress, build results, tests, logs, history and even run builds from truly anywhere.

Features

The core features of TeamCity Companion are:

  • Support for multiple TeamCity servers
  • Single sign-on
  • View and filter projects and builds
  • View build results, changes, artifacts and logs
  • View test results
  • View build history and charts
  • View self-updating build radiator
  • Start builds, optionally with custom parameters
  • Flag build types and set up notifications for build failures

Support for multiple TeamCity servers

You can configure any number of TeamCity servers, so it is easy to keep track of your open-source projects that might be hosted and tested elsewhere as well as your day-job builds at the same time.

Each server can be configured to use either a guest login if available, or a specific user account.

Single Sign-On

Your credentials are securely saved in the ios Keychain and used only to authenticate to the configured TeamCity server. You can hop right on to the server from the app (e.g. to review build result details) without having to re-authenticate - never type in your user name or password again.

View and filter projects and builds

All projects are listed in alphabetical order, optionally filtered to only show "tagged" projects. A project can be tagged by toggling its tag indicator.

Each build displays additional information if available:

  • Name and last result (failure or success) of each build type for each expanded project
  • Time the build ran
  • Build duration (TeamCity 8.1+)
  • Status text (TeamCity 8.1+)
  • An indicator for builds currently still running and their pending result
Tapping a project expands or minimizes it - build information is only shown for expanded projects.

Tapping a build result selects it and an actions toolbar is shown on the bottom. The toolbar gives you quick access to following capabilities:
  • View the build log / build results details
  • Show test results
  • Trigger a new build of the same type
  • View build history
  • Show build radiator
  • Flag or unflag this build type

Review build results

Review the build summary, all changes that were introduced in the build, the produced build artifacts as well as the full build log in a single view. To dive in deeper you can view the build or the changes within a web view that automatically authenticates you with your TeamCity server. From here you can navigate freely within your TeamCity server web UI if needed.

Review test results

Review the test results of the selected build.

Review build history

Review the recent build history either as a tabular view or as a chart.

View build radiator

To keep up with a build or a build chain while it is running you can use the build radiator view. The build radiator is self-updating with the current status of the build.

This includes:

  • Overall progress based on the expected run time as determined by TeamCit
  • Current success / failure status (green is passing)
  • Any status and progress text for the current step (e.g. number of completed tests)
  • Status of all of the build dependencies
  • Final build results

Flag build types

Flag any build type so you can keep track of it in a the special flagged build types view that gives you a concise summary of the last outcome of these builds only. This is a great way to keep up-to-date on the builds that are most relevant to you, regardless of the project they are in.

View build stream

Review the latest activity of build results on all serves. Ordered by time, and optionally only showing failing builds this gives you a quick overview of how your TeamCity servers are doing currently. This can be useful if you are involved in many projects, or are maintaining build environments.

Tested TeamCity server versions

Version 1.1. of the app has been tested against TeamCity servers running versions 7.1.3, 8.0.4 and 8.1.

Version 2.0. of the app has been tested against TeamCity servers running versions 8.0.4 and 8.1.4.

Version 2.1. of the app has been tested against TeamCity servers running versions 8.0.4 and 9.0.1.

Support or Contact

Contact TeamCityCompanion@gmail.com for general feedback, questions, feature requests or bug reports.

Current feature requests and bug reports can be reviewed on the TeamCity Companion Trello board.

And of course, if you like the app please take the time to review and rate it in the app store (I hear it increases your build pass rate) - thank you!