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

# Insights

<div id="overview">
  # Overview
</div>

Insights analyzes your Qoder CLI Session History to generate a visual HTML Report, helping you understand your usage patterns—when you are most active, the types of tasks you primarily work on, the Programming Languages involved, the Complexity Distribution of your tasks, and how your usage trends evolve over time.

It aggregates Metadata scattered across numerous sessions into holistic Insights, making it ideal for periodic reviews of personal or project development activities.

<div id="generate">
  # Generate Report
</div>

In an interactive session, enter:

```shell theme={null}
/insights
```

Qoder will analyze your Session History, generate an HTML Report, and open it in your default browser. Progress prompts are displayed during generation, and the file path of the report is printed upon completion.

<div id="dimensions">
  # Analysis Dimensions
</div>

The Insights report covers the following dimensions:

* **Session Statistics**: Total number of sessions, total messages, and user messages.
* **Time distribution**: Activity distribution by hour (24-hour) and by day, reflecting your activity patterns throughout the day and over time.
* **Programming Language**: The Programming Languages involved and their proportions.
* **Topic category**: Distribution statistics of session topics.
* **Intent analysis**: Distribution statistics of session intents.
* **Complexity Distribution**: Distribution of tasks by low, medium, and high complexity.
* **Active Mode**: Active time periods and usage consistency.
* **Trend Analysis**: Activity trends over time.

<div id="data-source">
  # Data Source
</div>

Insights data is sourced from your local Session Log:

* **Session Metadata**: Such as start time, message count, etc.
* **Session Characteristics (facets)**: Such as topic, language, intent, complexity estimation, etc.

During analysis, the report aggregates this data and generates natural language insights and trend descriptions. The generated HTML Report is saved in a local temporary directory and opened in the browser.

<div id="when-to-use">
  # When to Use
</div>

* **Personal Review**: Understand the types of tasks you primarily work on over a period, and the languages and topics you invest in.
* **Activity Patterns**: Discover your most productive times of the day or your usage consistency.
* **Trend Observation**: Observe changes in usage volume and task complexity over time.

<div id="related">
  # Related
</div>

* To view billing-related information such as quota and session duration, see [view usage and quota](/en/cli/03-using-qoder-cli/05-optimizing-usage/usage).