Skip to main content

Configuring CodeTogether

Several settings are configured during the initial setup of your project. You can modify these settings and explore additional options to further tailor your experience.

Configuring the Intelligence Suite​

To configure the Intelligence Suite, select Settings from the sidebar in the CodeTogether Portal. You can then edit various settings at the following levels:

  • General
  • Corporate
  • Departments
  • Projects
  • Account

General Settings​

License​

Monitor the status of your CodeTogether license and its expiration date to ensure uninterrupted access to CodeTogether services.

To update your license:

  1. Click Enter New License.
  2. Paste the license details.
  3. Click Apply.

license

System Roles​

Assigning roles in the CodeTogether Intelligence Suite is a straightforward process but requires users to have logged in at least once using their Single Sign-On (SSO) credentials.

Once a user has been added to the system, they can be assigned as either:

  • Project Manager
  • Global System Administrator

Both roles have authorization to create new projects. However, project creators do not automatically gain access to all projects. Additional access must be granted by the respective Project Administrator, who can add individuals as either members or observers.

System Tuning​

Tune intelligence settings to match your company's specific needs. The following settings can be customized:

  • Target Daily Coding Hours—The average in-IDE development time targeted for developers. This is calculated as an average, so a busy day followed by a slower day can still meet the target.

  • Minimum Active Hours—The minimum time an engineer must spend actively working within the past two weeks (in hours) to be considered active.

  • Code Change Rate Per Hour—The expected rate of change in code size per hour, measured in characters.

  • Max Exploration Percentage—The maximum percentage of time allowed for exploration during task work.

Corporate Settings​

Company Details​

Displays the company name. This field is not editable.

Departments​

Departments help you organize related projects, enabling more effective management and goal alignment. To add a department, click New Department.

Observers​

Observers can be manually added. To add or remove observers, click Edit. To update an observer's role, click the Edit icon next to the person.

Department Settings​

Departments help structure related projects for more efficient management.

To edit a department's settings:

  1. Select the department from the drop-down menu.
  2. Update Department Details and associated Projects.

Department Details​

This area includes the Department Name and Description. To edit the details, click Edit.

Projects​

Projects within a department provide clear oversight of development workflows.

  • To add a project, click New Project.
  • For advanced customization, Project CLI commands offer additional configuration options.

Project Settings​

Projects are automatically added when you connect your repositories to CodeTogether.

To edit a project's settings:

  1. Select the project from the drop-down menu.
  2. Update the following:
    • Project Details
    • Members
    • Components
    • Repositories

Project Details​

Includes high-level project information. Click Edit to update this information.

Members​

View project members and their project role. Members are synced automatically from the issue tracker.

  • To add or remove members, update the issue tracker directly.
  • To edit a member’s role, click the Edit icon next to their name.

Components​

Components help organize source code into meaningful segments for better workflow insights. It's best to group moderately sized, cohesive sections of code, such as application layers or modules. Modifications to component definitions are automatically reflected across historical and current data in real time.

  • To add a component, click New Component.
  • To modify a component, click the Edit icon.

Repositories​

Displays repositories linked to the project, pulled from the connected issue tracker.

  • To update this list, update the repositories in the issue tracker.
  • To edit repository components, click the Edit icon.

Time Estimation​

This section is available only if connected to an issue tracker.

To make changes, click Edit Data and then customize the model as follows:

  • Work Effort—Define the patterns used for providing engineering effort (in hours, days, and weeks).
  • T-Shirt Sizing—Assign time ranges (in hours or days) to each t-shirt size (e.g., XS, S, M, L, or XL).
  • Story Points—Set the number of story points that correspond to time ranges (in hours or days).

Data Granularity​

The Data Granularity setting controls visibility and monitoring within CodeTogether, balancing insights with privacy.

  • Detailed workforce metrics—Developers have access to their own detailed metrics, while project managers gain a high-level overview of workforce activities.
  • Developers can see their own detailed metrics—Developers can view their own detailed metrics, but project managers have limited visibility into project activities.
  • Only high-level user metrics are reported—Developers receive minimal project-related data, with insights primarily focused on project-level workflows.
  • No user metrics are reported—No detailed user information is available in the portal, including time-tracking details on task-related files.

A more granular approach maximizes management insights, while a less granular approach prioritizes privacy.

Task Management​

Define branch patterns to enhance automated task tracking. By specifying primary work branches where completed changes are merged, CodeTogether can differentiate feature branches from main development workflows, streamlining task organization and visibility.

Account Settings​​

Use Account Settings to personalize your user preferences in CodeTogether.

Profile​

Displays the name used to identify the user in the CodeTogether interface. To edit this Display Name, click Edit.

Email Addresses​

Configuring your email settings is essential for ensuring that your commits are correctly associated with your user account across different Git clients and your Integrated Development Environment (IDE). You can link multiple email addresses to your CodeTogether account.

Configuring the Live Module​

The Live Module allows real-time collaboration in CodeTogether. You can configure settings based on your IDE as follows:

  • VS Code—Select View > Extensions, and then click the Manage icon next to the CodeTogether entry.
  • IntelliJ—Select File > Settings > CodeTogether.
  • Eclipse—Select Windows > Preferences > CodeTogether.