> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heygarth.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roi settings

# ROI Settings Guide

## Overview

The ROI Settings module allows organizations to configure cost and productivity assumptions used for ROI calculations across LLM tools, AI coding tools, PR reviews, and Cursor usage metrics within the Engineering Metrics Dashboard.

These settings help estimate:

* Productivity improvements
* Development time savings
* Human effort reduction
* Operational cost optimization
* AI adoption impact

The ROI Settings feature is available under the **Settings** module.

## Step 1: Navigate to ROI Settings

1. Open the Engineering Metrics Dashboard.
2. Navigate to **Settings** from the left sidebar.
3. Open the **ROI Settings** section.

The ROI Settings page contains the following tabs:

* LLM Settings
* AI Coding Tool Settings
* PR Settings
* Cursor Settings

# LLM Settings

## Overview

The LLM Settings tab allows administrators to configure ROI-related parameters for Large Language Model usage.

Configured settings are used to estimate:

* Token processing costs
* Human processing effort
* Developer cost savings
* AI productivity improvements

## Viewing Existing LLM Settings

The LLM Settings table displays:

| Field                  | Description                       |
| ---------------------- | --------------------------------- |
| Provider Name          | Name of the LLM provider          |
| Token Input Prices     | Cost of input tokens              |
| Input Token Limits     | Token processing limits           |
| Token Prices           | Pricing configuration             |
| Human Processing Speed | Estimated manual processing speed |
| Developer Hourly Cost  | Average developer hourly rate     |

### Example Provider

* OpenAI

## Add or Edit LLM Settings

1. Click **Add LLM Setting** or the **Edit** icon beside an existing provider.
2. The **Edit LLM Settings** window will open.

### Configure LLM Information

#### Provider

Select the LLM provider.

**Example:** OpenAI

#### Tokens Count for Pricing

Enter the token count unit used for pricing calculations.

**Example:** 1,000,000

#### Input Tokens / Day

Specify the estimated number of input tokens processed daily.

#### Output Tokens / Day

Specify the estimated number of output tokens generated daily.

#### Human Processing Speed

Configure the estimated human processing speed.

**Example:** Tokens processed per hour

#### Developer Hourly Cost

Enter the estimated developer hourly rate.

**Example:** \$40/hr

#### Input Token Price

Specify the input token pricing value.

#### Output Token Price

Specify the output token pricing value.

### Save Settings

1. Review the configured values.
2. Click **Save Setting**.

The ROI configuration will now be updated successfully.

# AI Coding Tool Settings

## Overview

The AI Coding Tool Settings tab allows organizations to configure ROI assumptions for AI-assisted coding platforms.

This helps estimate:

* Developer productivity improvements
* Daily time savings
* AI coding tool operational value

## Viewing Existing AI Coding Tool Settings

The settings table displays:

| Field                    | Description                 |
| ------------------------ | --------------------------- |
| Tool Name                | AI coding platform          |
| Per Seat Cost            | Cost per licensed user      |
| Hours Saved / User / Day | Estimated productivity gain |
| Developer Hourly Cost    | Average developer cost      |

### Example Tool

* GitHub Copilot

## Add or Edit AI Coding Tool Settings

1. Click **Add AI Coding Tool** or the **Edit** icon.
2. The **Edit ROI Settings** window will open.

### Configure AI Coding Tool Information

#### Coding Tool Name

Select the AI coding tool.

**Example:** GitHub Copilot

#### Per Seat Cost

Enter the subscription or licensing cost per user.

#### Hours Saved / User / Day

Specify the estimated daily time savings per user.

#### Developer Hourly Cost

Enter the average developer hourly rate.

### Save Settings

1. Verify all entered values.
2. Click **Save Setting**.

# PR Settings

## Overview

The PR Settings tab allows administrators to configure ROI estimates for pull request review activities.

These values help estimate:

* Time saved during code reviews
* Reviewer productivity improvements
* Cost savings from optimized review workflows

## Viewing Existing PR Settings

The PR Settings table displays:

| Field                   | Description                 |
| ----------------------- | --------------------------- |
| Hours Saved Per PR      | Estimated review time saved |
| Developer Cost Per Hour | Average reviewer cost       |

## Add or Edit PR Settings

1. Click **Add PR Setting** or the **Edit** icon.
2. The **Edit ROI Settings** window will open.

### Configure ROI Information

#### Hours Saved Per PR

Enter the estimated number of hours saved for each pull request review.

**Example:** 5 hours

#### Developer Cost Per Hour

Specify the average developer hourly cost.

**Example:** \$50/hr

### Save Settings

1. Review the values.
2. Click **Save Setting**.

# Cursor Settings

## Overview

The Cursor Settings tab allows organizations to configure ROI assumptions specific to Cursor AI coding usage.

Configured values help estimate:

* AI-assisted coding productivity
* Developer time savings
* Cursor subscription ROI

## Viewing Existing Cursor Settings

The Cursor Settings table displays:

| Field                    | Description                 |
| ------------------------ | --------------------------- |
| Per Seat Cost            | Cost per licensed user      |
| Hours Saved / User / Day | Estimated productivity gain |
| Developer Cost Per Hour  | Average developer cost      |

## Add or Edit Cursor ROI Settings

1. Click **Add Cursor ROI Setting** or the **Edit** icon.
2. The **Edit Cursor ROI Settings** window will open.

### Configure Cursor ROI Information

#### Per Seat Cost

Enter the subscription cost per user seat.

#### Hours Saved Per User Per Day

Specify the estimated daily time savings per developer.

#### Developer Cost Per Hour

Enter the average hourly developer cost.

### Save Settings

1. Review the configured values.
2. Click **Save Setting**.

# Troubleshooting

## Unable to Save ROI Settings

### Possible Causes

* Missing required fields
* Invalid numeric values
* Incorrect configuration format

### Recommended Actions

* Verify all mandatory fields are completed
* Ensure numeric values are entered correctly
* Retry saving the configuration

## ROI Calculations Not Updating

### Possible Causes

* Dashboard refresh delay
* Configuration changes not saved
* Metrics synchronization pending

### Recommended Actions

* Verify settings were saved successfully
* Refresh the dashboard
* Wait for the next synchronization cycle

# Best Practices

* Periodically review ROI assumptions for accuracy
* Use realistic developer cost estimates
* Align token pricing with current provider pricing models
* Regularly update AI tool subscription costs
* Validate productivity assumptions using actual engineering usage data

# Summary

The ROI Settings module enables organizations to configure productivity and cost assumptions used across Engineering Metrics, LLM Metrics, AI Coding Tools Metrics, and PR review analytics.

By maintaining accurate ROI settings, teams can better evaluate engineering efficiency, AI adoption impact, and operational cost savings across the organization.