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:

  • Account—User-specific (individual account) configuration.
  • Corporate—Organization-wide (company-level) configuration.
  • Departments—Configuration at the department level within the organization.
  • Projects—Configuration for a specific project.
  • System—Global configuration for the entire installation.

Settings Sectiossn

System 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.

Settings System License

System Tuning​

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

  • Minimum Active Hours—The minimum time an engineer must spend engaged in code-related activities (e.g., writing code, reviewing pull requests) within the past two weeks (in hours) to be considered active.
  • 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.
  • 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.

Settings System Tuning

Security Settings​

Manage global security configurations for your system, including who can participate in live coding sessions.

  • Require Project & Repository Access-Restricts participation to users who not only belong to the same project but also have permission to access the source repositories involved in the session.

Settings Security Settings

Corporate Settings​

Company Details​

Displays the company name. This field is not editable.

Settings Corportate Details

Departments​

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

Settings Corportate Departments

Observers​

You can manually manage observers as follows:

  • To add a new observer, click New Observer.
  • To remove an observer, click the minus (-) icon next to their name.
  • To update an observer's role, click the Edit (✏️) icon next to their name.

Settings Corportate Observers

Department Settings​

Department Details​

Departments help structure related projects for more efficient management.

Settings Department Details

Department Projects​

This section lists all projects that have been added or linked to the department. To add more projects, click Add Project.

Settings Department Projects

Department Observers​

You can manually manage observers as follows:

  • To add a new observer, click New Observer.
  • To remove an observer, click the minus (-) icon next to their name.
  • To update an observer's role, click the Edit (✏️) icon next to their name.

Settings Department Observers

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.

Settings Projects Details

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.

Settings Projects Members

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.
  • To delete a component, click the Delete icon.

Settings Projects Components

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.

Settings Projects Repositories

Time Estimation​

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

To make changes, click Edit 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).

Settings Projects Time Estimation

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.

Settings Projects Task Management

Advance​

In this section, you can monitor the project's synchronization status, manage connections with external services (such as the issue tracker), and perform critical project lifecycle actions.

View the last sync date for each entity—Issues, Members, Pull Requests, and Repositories—and check for any sync errors.

Sensitive actions for project administrators:

  • Disconnect Project-Disconnect this project from the issue tracker.
  • Delete Project-Permanently remove this project and all associated data.
note

Actions in this section may affect project integrity and data tracking. Proceed with care.

Successful Synchronization-All entities are synchronized correctly and no errors were reported.

Settings Projects Advance Succeed

Synchronization In Progress-Some entities are currently syncing or awaiting synchronization. Please wait or retry if needed.

Settings Projects Advance Sync

Synchronization Failed-Errors occurred while syncing one or more entities. Review the error messages and take corrective actions.

Settings Projects Advance Failed

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.

Settings Account Profile

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.

Settings Account Email

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.