Proactive Intelligence Tool

What is it?

The Proactive Intelligence Tool is Yukkai's always-on alert system that surfaces what matters to you — without you having to ask. Think of it as a smart assistant that watches your tasks, calendar, and schedule in the background, then nudges you with timely alerts when something needs your attention.

Unlike the Watchlist Tool (which monitors external data sources like stock prices or web pages), the Proactive Intelligence Tool focuses on your own life: upcoming deadlines, overloaded days, morning briefings, and forgotten tasks.

How it works

The tool runs a proactive loop — a recurring background analysis cycle that evaluates your tasks, schedule, and priorities. Each cycle can generate alerts with varying priority levels (low, medium, high). Alerts are then surfaced to you, typically through Telegram.

Here's the lifecycle of a proactive alert:

1. Detection — The loop identifies something worth surfacing (e.g., a task due tomorrow, a calendar conflict).
2. Alert created — An alert is generated with a priority level and a human-readable summary.
3. Notification — You receive the alert (usually via Telegram).
4. You respond — You either dismiss it (mark it seen) or act on it (confirm you took action).
5. Logged — The alert is recorded in history for future reference.

You can configure how often the loop runs, when you get your morning briefing, and how many alerts you can receive per day — keeping you informed without being overwhelmed.

How to use it

The tool is controlled through natural language commands in your Yukkai chat. Here's what you can do:

Check pending alerts

Ask Yukkai to show unread alerts:

Show me my pending proactive alerts.

Yukkai will list any unread alerts, sorted by priority.

View alert history

To review past alerts:

What proactive alerts have I had recently?

By default, Yukkai shows the last 10 alerts. You can ask for more or fewer.

Dismiss or act on an alert

When you receive an alert, you have two response options:

• Dismiss — "I've seen this alert, but I'm not taking action right now."
• Act — "I've seen this alert AND I've done something about it."

Mark the overdue task alert as done — I just finished that task.

Yukkai uses the act action in this case, which both dismisses the alert and logs that you took action.

Force an immediate analysis

Don't want to wait for the next scheduled cycle? You can trigger one on demand:

Run a proactive check right now.

Yukkai will run an immediate analysis cycle and surface any new alerts.

Configure the proactive loop

You can fine-tune how the proactive system behaves:

• Morning briefing hour — When your daily summary is delivered (0–23).
• Check interval — How often the loop runs, in minutes (minimum: 5, maximum: 1440).
• Max alerts per day — A cap to prevent alert fatigue (1–50).
• Enabled / disabled — Turn the entire loop on or off.

Set my morning briefing to 7 AM, and limit me to 15 proactive alerts per day.

Examples

Morning briefing

Each day at your configured hour, Yukkai delivers a morning briefing — a concise overview of your day ahead, including scheduled events, tasks due, and any potential conflicts.

Give me my morning briefing.

Overdue task warning

If a task passes its due date without being completed, the proactive loop surfaces a warning:

You have an overdue task: "Submit quarterly report" — due 2 days ago.

Overload detection

When your schedule is packed, Yukkai can warn you before you overcommit:

⚠️ You have 4 meetings and 6 due tasks tomorrow. Consider rescheduling 2 tasks.

Pausing the proactive loop

Going on vacation or just need a break from alerts?

Turn off proactive alerts for now.

Tips & best practices

• Use act instead of dismiss when you've genuinely taken action on an alert. This gives Yukkai better context about what you follow through on, improving future recommendations.
• Set a reasonable check interval. Too frequent (every 5 minutes) creates noise; too infrequent (once a day) means you might miss time-sensitive alerts. 15–30 minutes is a good sweet spot for most users.
• Cap your daily alerts. Use max_alerts_per_day to prevent alert fatigue. 10–20 is a sensible range depending on how busy your schedule is.
• Don't confuse it with Watchlist. Proactive Intelligence watches your tasks and calendar. The Watchlist Tool watches external data (stocks, news, web pages). Use both together for full coverage.
• Force a cycle before important days. If you have a big presentation or deadline coming up, trigger an immediate analysis (run_cycle) to make sure nothing slipped through the cracks.
• Review history periodically. Checking your alert history helps you spot patterns — like recurring overdue tasks — that you might want to address at the root.