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

# Proactive Insights

> AI-discovered patterns and correlations across your helpers

Proactive Insights automatically analyzes your data to surface meaningful patterns, trends, and correlations you might have missed.

<Info>
  Proactive Insights requires a Pro plan or higher.
</Info>

## What Are Proactive Insights?

Peanuts continuously analyzes your entries across all helpers to discover:

* **Trends**: Changes over time (spending increasing, exercise decreasing)
* **Anomalies**: Unusual entries that stand out from your patterns
* **Correlations**: Connections between different helpers (sleep affects mood)
* **Streaks**: Consistency patterns worth celebrating or noting

## Enabling Proactive Insights

<Steps>
  <Step title="During Onboarding">
    Choose to enable proactive insights when setting up your account.
  </Step>

  <Step title="Or in Settings">
    Go to Settings and toggle "Proactive Insights" on.
  </Step>
</Steps>

<Warning>
  Insights analyze your personal data patterns. Only enable if you're comfortable with AI reviewing your entries to find correlations.
</Warning>

## Types of Insights

<CardGroup cols={2}>
  <Card title="Trend Detection" icon="chart-line">
    Identifies when metrics are consistently rising or falling over time.
  </Card>

  <Card title="Anomaly Alerts" icon="triangle-exclamation">
    Flags entries that differ significantly from your usual patterns.
  </Card>

  <Card title="Cross-Helper Correlations" icon="diagram-project">
    Discovers connections between different aspects of your life.
  </Card>

  <Card title="Streak Recognition" icon="fire">
    Celebrates consistency and notes when streaks are at risk.
  </Card>
</CardGroup>

## Cross-Helper Correlations

The most powerful insight type connects patterns across different helpers.

**Examples:**

* "Your mood ratings are 23% higher on days you exercise"
* "You tend to spend more on food when you sleep less than 7 hours"
* "Your productivity scores correlate with morning meditation entries"

<Info>
  Correlations require at least 2 weeks of data across multiple helpers to generate meaningful patterns.
</Info>

## Viewing Insights

Insights appear in several places:

1. **Notification bell**: New insights show as notifications
2. **Dashboard**: Insight cards on your home screen
3. **Helper detail**: Relevant insights on individual helpers
4. **Telegram**: Use `/insights` command to see recent discoveries

## Insight Actions

For each insight, you can:

* **Dismiss**: Hide this insight (it won't reappear)
* **Mark helpful**: Improves future insight relevance
* **Mark not helpful**: Reduces similar insights
* **View details**: See the underlying data

## Privacy & Control

<AccordionGroup>
  <Accordion title="Your Data Stays Private">
    Insights are generated only for your account. No data is shared or used to train models.
  </Accordion>

  <Accordion title="Disable Anytime">
    Turn off proactive insights in Settings to stop all analysis.
  </Accordion>

  <Accordion title="Per-Helper Control">
    Exclude specific helpers from insight analysis in helper settings.
  </Accordion>
</AccordionGroup>

## Insight Timing

Insights are generated:

* **Daily**: Overnight analysis of recent entries
* **Weekly**: Deeper pattern analysis on weekends
* **On-demand**: When you request via Telegram `/insights`

New insights appear as notifications. Old insights expire after 30 days if not acted upon.

## Telegram Integration

Access insights via your Telegram bot:

```
/insights
```

Returns your most recent insights with options to mark as helpful or dismiss.

## Best Practices

<Tip>
  The more consistently you log entries, the better your insights become. Sporadic data leads to weaker pattern detection.
</Tip>

* Log entries regularly for stronger patterns
* Use multiple helpers to enable cross-correlations
* Provide feedback on insights to improve relevance
* Review insights weekly to catch important trends

## Related

<CardGroup cols={2}>
  <Card title="Smart Nudges" icon="bell" href="/features/notifications">
    Timely reminders based on your patterns
  </Card>

  <Card title="Ask Peanuts" icon="message-bot" href="/core-concepts/ask-peanuts">
    Ask questions about your data directly
  </Card>
</CardGroup>