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

# AI usage

> Which AI tools your organization uses, how much and by how many people. Where each figure comes from, the filters, and why some figures are missing

**AI usage**, under **Teams** at [synapse.synheart.ai](https://synapse.synheart.ai), shows which AI tools your organization uses, how much, and by how many people. It counts use. It never names a person, and it doesn't say whether the use helped. For that, see [AI Effectiveness](https://docs.synheart.ai/synapse/ai-effectiveness.md).

Synapse Leads and Admins can open it on paid plans. Members don't see it.

## Before you start

Usage appears once at least one AI tool is connected under **Admin → Connectors** and has reported for the period. Until then the page says *No AI usage yet* and links to Connectors. See [Connectors](https://docs.synheart.ai/synapse/connectors.md) for the tools Synapse can read.

## Filters

* **Department.** Shown once your organization has departments. Choose **All departments** or one department.
* **Period.** **7 days**, **30 days** or **90 days**. Changes are compared with the previous period of the same length, such as *+12% vs prior period*.
* **Tools.** When more than one tool reports, pick the tools to include.

## What's on the page

### Summary

| Figure | What it counts |
| - | - |
| **Active people** | People who used at least one AI tool in the period. |
| **Tokens** | Tokens used across the tools. |
| **Requests** | Requests sent to the tools. |
| **Sessions** | Sessions, for tools that report them. |

The line under **Tokens**, **Requests** and **Sessions** names where the figure came from: **Connected tools**, **Claude Code sessions** or **Provider reports**. Synapse takes the first source that reported a figure and never adds sources together, so nothing is counted twice.

### Tokens over time

Tokens per day, grouped by **Model** or by **Tool**. The table under the chart shows each model's or tool's tokens, requests and sessions, and its share of tokens.

### People

* **New people**: first seen using AI in this period.
* **Sessions per person** and **Tokens per person**.
* **Daily**, **Weekly** and **Monthly active people**, as averages over the period.
* **Active people by tool**, with each tool's share of active people.
* **Usage by department**: active people, share of tokens and tokens per person for each department.

### Output from AI-assisted coding

**Commits**, **Pull requests**, **Lines added** and **Files changed**, as the AI tools report them. These describe output that came with AI use. They don't measure productivity. For delivery figures from your repositories, see [Metrics explained](https://docs.synheart.ai/synapse/metrics.md).

## Missing figures

A figure is left out, rather than shown as zero, when:

* **no tool reported it.** Not every tool reports sessions or requests, for example. A figure nobody has reported yet says *Not reported yet*.

## Export CSV

**Export CSV**, at the top, downloads the figures on screen with the same filters. It's available to Synapse Leads and Admins. For scheduled exports, see [Exports](https://docs.synheart.ai/synapse/exports.md).

## Related

* [AI spend](https://docs.synheart.ai/synapse/ai-spend.md): what the tools cost, and which seats go unused.
* [AI Effectiveness](https://docs.synheart.ai/synapse/ai-effectiveness.md): Reach and Habit, which count the same people from a different angle.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.