View on GitHub

Calendar

DuckTape's calendar feature helps you manage events and schedules efficiently. You can use the command line or natural language commands to interact with your calendar.

Adding Events

To add an event to your calendar, you can use either a command-line instruction or natural language. Here's how:

Using Command-Line

# Add an event to the calendar
ducktape calendar create "Team Meeting" 2025-04-15 13:00 14:00 "Work" --contacts "Joe Duck" --zoom

Using Natural Language

DuckTape also supports natural language commands for creating events. To use natural language capabilities:

# First, start the DuckTape interactive terminal
$ ducktape
Welcome to DuckTape! How can I assist you today?
Example: schedule a meeting with Siya tomorrow at 3pm about project review
🦆 create an event Team Meeting with Joe Duck for this coming Tuesday
Important: To use natural language, first type ducktape and press Enter to start the interactive terminal. Then you can enter your natural language commands at the duck prompt (🦆).

When you use this natural language command, DuckTape processes it as follows:

Terminal
[2025-04-14T22:05:26Z INFO ducktape::app] Proceeding with natural language processing
Processing natural language: 'ducktape "create an event Team Meeting with Joe Duck for this coming Tuesday"'
Translated to command: ducktape calendar create "Team Meeting" 2025-04-22 11:00 12:00 "Work" --contacts "Joe Duck"
Sanitized command: ducktape calendar create "Team Meeting" 2025-04-22 11:00 12:00 Work --contacts "Joe Duck"
[2025-04-14T22:05:29Z INFO ducktape::command_processor] Executing command 'calendar' with arguments: ["create", "Team Meeting", "2025-04-22", "11:00", "12:00", "Work"]
[2025-04-14T22:05:29Z INFO ducktape::calendar] Creating event with 1 contact names: ["Joe Duck"]
[2025-04-14T22:05:32Z INFO ducktape::calendar] Found 2 email(s) for contact 'Joe Duck': ["joe.duck@example.com", "jduck@example.com"]
[2025-04-14T22:05:33Z INFO ducktape::calendar] Calendar event created: Team Meeting at 2025-04-22 11:00
[2025-04-14T22:05:35Z INFO ducktape::calendar] Calendar event created in 1/1 calendars
Note: Syncing ensures that your events are always up to date across all platforms.

Best Practices

  • Use clear and descriptive titles for your events.
  • Set reminders for important events to stay on track.
  • Regularly review your calendar to avoid conflicts.

Calendar Command Examples

  • List all calendars: 
    ducktape calendar
  • Create a calendar event: 
    ducktape calendar create "Project-Review" 2025-04-20 15:00 16:00 "Work"
  • Add attendees by email: 
    ducktape calendar create "Team-Sync" 2025-04-15 10:00 11:00 "Work" --email "john@example.com,jane@example.com"