Scheduled Tasks
After reading this page you will be able to: create automated scheduled tasks via chat or manual forms, configure frequencies, and review execution logs and notifications.
1. What Are Scheduled Tasks
Section titled “1. What Are Scheduled Tasks”Scheduled Tasks allow you to define instructions and recurring schedules so that designated AI assistants run repetitive work automatically in the background (such as daily industry news briefings, automated daily summaries, or periodic file checks).
2. Two Ways to Create Tasks
Section titled “2. Two Ways to Create Tasks”You can set up tasks quickly via natural language chat or configure them precisely using the visual form:
Method 1: Create via Conversation (Recommended)
Section titled “Method 1: Create via Conversation (Recommended)”In any chat session, instruct the AI to schedule a task directly. The AI invokes the /cron skill automatically:
Every weekday at 9:00 AM, search for the latest AI industry news and summarize it as a Markdown file in the project root directory.The AI parses the schedule and requirements, presenting a confirmation card to generate the scheduled task upon approval.
Method 2: Create Manually in the Scheduled Tasks Page
Section titled “Method 2: Create Manually in the Scheduled Tasks Page”Entry: Sidebar → Scheduled Tasks → New Task
Fill out the task configuration dialog fields:
| Field | Meaning and Requirement | Notes |
|---|---|---|
| Task Name | Short descriptive title | E.g., “Daily Morning Industry Digest” |
| Instruction | The full prompt sent to the AI each run | Must clearly specify inputs and expected deliverables |
| Assistant | The AI assistant running the task | Choose from official or custom assistants |
| Execution Mode | New Session or Persistent Session | Note: Cannot be changed after creation. Persistent accumulates context in one thread; New Session starts fresh each time |
| Schedule Rule | Frequency and schedule | Supports Manual, Hourly, Daily, Weekdays, Weekly, or custom Cron expressions |
| Queue Protection | Prevents overlapping runs | When enabled, skips the current scheduled run if the previous one is still executing |
| Advanced Settings | Linked project folder and default model | Sets the target working directory for file reads and writes |
3. Task Management and Controls
Section titled “3. Task Management and Controls”The Scheduled Tasks page provides comprehensive controls over task lifecycles:
- Status Monitoring: Tracks task states (Active, Paused, Error, New Executions) along with last run status, error details, and next scheduled run time.
- Run Now and Pause/Resume: Click “Run Now” to trigger an immediate run without waiting for the schedule, or pause and resume scheduling at any time.
- Jump to Conversation: Click “View Session” or “Jump to Conversation” to review the full conversation and artifacts generated during the run.
- Delete Task: Deleting a task prompts for confirmation (with an option to delete all associated historical sessions).
4. Desktop Features and Reliability
Section titled “4. Desktop Features and Reliability”- Keep Awake (Wake Lock): The desktop app coordinates power management to prevent system sleep from interrupting scheduled jobs.
- Missed Run Catch-up: If the computer is powered off or asleep during a scheduled time, a notification alerts you upon relaunch.
- Completion Notifications: Receives system notifications upon task completion, with unread badges on the sidebar Scheduled Tasks icon.
How to Verify Success
Section titled “How to Verify Success”- The new task card appears in the Scheduled Tasks list with an “Active” status and a valid next run time.
- Clicking “Run Now” successfully invokes the assistant and generates the expected output in the associated session.
- System notifications notify you upon completion, and “View Session” reveals the verified artifacts.