Shortcuts Integration
Build Apple Shortcuts actions that interact with Elysium. Query schedules, create items, and automate workflows across apps.
Overview
Elysium exposes its functionality to Apple Shortcuts through App Intents. Users can build automations that span multiple apps—trigger Elysium actions from other apps, or use Elysium data in complex workflows.
These Shortcuts actions work on macOS, iOS, and iPadOS wherever Elysium is installed.
Built-in Shortcuts Actions
Elysium includes these actions out of the box:
Get Schedule Items
Query items by type, date range, tags, or status
Create Item
Add new tasks, events, habits, or other item types
Update Item
Modify existing items—change status, dates, or properties
Get Today's Schedule
Retrieve all items scheduled for today
Complete Task
Mark a task as done with optional completion time
Log Habit
Record a habit completion for today
Using Shortcuts with Plugins
While plugins can't create new Shortcuts actions (those require native Swift code), you can use the built-in actions to trigger your plugin's functionality indirectly.
Pattern: Use Tags as Triggers
Create a Shortcut that adds a specific tag to an item, then have your plugin listen for that tag:
// In your plugin
elysium.events.on("task.updated", async (task) => {
if (task.tags.includes("sync-to-notion")) {
await syncToNotion(task);
// Remove the trigger tag
await elysium.tasks.update(task.id, {
tags: task.tags.filter(t => t !== "sync-to-notion")
});
}
});Example Shortcuts
Here are some example Shortcuts users can build with Elysium:
Morning Briefing
Get today's schedule → Filter to tasks and appointments → Have Siri read them aloud
Quick Capture
Ask for input → Create task in Elysium → Show confirmation
Focus Mode Setup
Get current event → If type is “Deep Work” → Enable Focus Mode → Start Pomodoro timer
End of Day Review
Get today's completed tasks → Count them → Log to Health app → Show summary
Tips for Automation
Use Specific Tags
Create unique tags for automation triggers (e.g., #auto-archive) so they don't conflict with regular tags.
Clean Up After Processing
Remove trigger tags after processing to prevent the action from running again.
Document Your Triggers
If your plugin responds to specific tags or item properties, document them clearly so users know how to trigger functionality from Shortcuts.