Scheduling Tool

What is it?

The Scheduling Tool is Yukkai's built-in calendar and time-management assistant. It connects to your Apple Calendar to provide daily briefings, find free time slots, detect scheduling conflicts, suggest when to work on your tasks, and create new events — all through natural language.

Think of it as a personal scheduling assistant that understands your calendar and your tasks, and helps you make the most of your time.

How it works

The tool integrates directly with Apple Calendar. The first time you use any scheduling feature, Yukkai will automatically request calendar permission. Once granted, the tool can read your existing events and create new ones.

It offers seven actions, each serving a different scheduling need:

Action	What it does
Morning briefing	Gives you a formatted overview of your day ahead
Suggest schedule	Proposes when to work on unscheduled tasks
Apply schedule	Commits a suggested time slot to your calendar
Calendar today	Lists all of today's calendar events
Free slots	Finds available time windows in your calendar
Detect overload	Warns you about upcoming scheduling conflicts or heavy days
Calendar create	Creates a new calendar event manually

Note: The Scheduling Tool does not support recurring or scheduled prompts. If you need a task to run on a recurring schedule, use the /cron-add slash command instead.

How to use it

All scheduling features work through natural language. Just ask Yukkai what you need in plain English:

• "What does my day look like?" → triggers a morning briefing
• "Do I have any free time this week?" → searches for free slots
• "Am I overloaded over the next few days?" → runs detect overload
• "Plan my unscheduled tasks for the next two weeks." → runs suggest schedule
• "Create a meeting tomorrow at 2pm for 90 minutes." → uses calendar create

You don't need to specify action names — Yukkai understands your intent and picks the right action automatically.

Examples

Getting your morning briefing

Ask for a daily overview:

What's my morning briefing?

Yukkai returns a formatted summary of today's events, any overdue tasks, and relevant alerts — all in one place.

Finding free time slots

Find me free slots of at least 45 minutes over the next 5 days

The tool searches your calendar for open windows. You can control the search range (up to 14 days) and the minimum slot duration (down to 5 minutes).

Detecting overload

Check if I'm overloaded in the next week

The tool scans your calendar for conflicts, back-to-back meetings, or unusually heavy days and warns you in advance.

Suggesting a schedule for tasks

Suggest a schedule for my unscheduled tasks over the next 10 days

Yukkai analyzes your calendar, finds suitable time slots, and proposes when to work on each task. To confirm a suggestion:

Apply the suggested schedule for the design review task

This creates the calendar event for you. Note that you must apply suggestions within the same session — the cache is session-scoped and not persistent.

Creating a calendar event

Create a "Dentist appointment" on Friday at 9am for 30 minutes

You can also add notes:

Create a "Team sync" tomorrow at 3pm for 60 minutes with notes: "Prepare quarterly metrics"

The start date should be in ISO-8601 format (e.g., 2025-01-24T15:00:00), but Yukkai will handle the conversion from natural language for you.

Tips & best practices

• Ask for briefings in the morning. The morning briefing pulls together your calendar, tasks, and alerts into a single snapshot — a great way to start the day.
• Use free slots before adding events. Instead of guessing when you're free, ask Yukkai to find available windows first, then create your event in one of them.
• Check for overload proactively. Run an overload check at the start of each week to catch conflicts early, before they become problems.
• Apply schedule suggestions in the same session. The suggest schedule → apply schedule flow relies on a session cache. If you close the session, suggestions are lost and you'll need to generate new ones.
• Combine with the Task Manager. Use the Scheduling Tool alongside the Task Manager to plan when you'll work on your tasks and keep your calendar and to-do list in sync.
• Calendar permission is required. The first time you use any scheduling action, macOS will prompt you to grant calendar access. Without it, scheduling features won't work.