DuckTape 🦆 - Your Personal TimeAI

Key Features

Natural Language Processing

Simply type what you want to do in plain English. DuckTape understands context, dates, times, and recurring events.

Multiple Calendar Support

Work with multiple calendars, smart date understanding, and automatic calendar selection based on context.

Zoom Integration

Create Zoom meetings directly in your calendar events with automatic link generation.

Three Ways to Use DuckTape

DuckTape offers flexible usage options to match your workflow preferences

1. Interactive Hybrid Mode

Enter an interactive shell where you can use both direct commands and natural language

$ ducktape
🦆 calendar list
🦆 schedule a meeting in 30 minutes with Joe
🦆 remind me to call Jane tomorrow at 2pm

2. Direct CLI Commands

Run structured commands directly from your shell for precise control

$ ducktape calendar list
$ ducktape calendar create "Team Meeting" 2025-05-06 13:00 14:00 "Work" --contacts "Joe Duck" --zoom
$ ducktape note list

3. Natural Language via AI

Use natural language directly from your shell with the ai subcommand

$ ducktape ai schedule a meeting in 30 minutes with Joe
$ ducktape ai remind me to call Jane tomorrow at 2pm
$ ducktape ai create a zoom event today at 10am called Team Check in and invite Joe Duck

Full Documentation

Configuration with config.toml

DuckTape uses a config.toml file located in the root of the repository to manage its settings. This file allows you to configure various aspects of the application, such as whether to use a language model (LLM) or operate in Terminal Mode.

Example Configuration

[language_model]
provider = "OpenAI"  # Options: "OpenAI", "Grok", "DeepSeek", comment out by adding # in front of provider or leave empty for Terminal Mode

[calendar]
default_calendar = "Work"
default_reminder_minutes = 15
default_duration_minutes = 60

[reminder]
default_list = "Reminders"
default_reminder = true

[notes]
default_folder = "Notes"

Switching Between Modes

To switch between Terminal Mode and Natural Language Mode, update the provider field under the [language_model] section:

Terminal Mode: Leave the provider field empty.
Natural Language Mode: Set the provider field to one of the supported AI providers (e.g., OpenAI, Grok, or DeepSeek).

Setting Default Calendar

To set a default calendar for events, update the default_calendar field under the [calendar] section:

[calendar]
default_calendar = "Work"

Viewing and Editing Configuration

To view the current configuration, open the config.toml file in the root of the repository. To change settings, edit the file and save your changes.

Key Settings

Language Model Provider: Set the provider field under [language_model] to enable natural language processing. Leave it empty to use Terminal Mode.
Default Calendar: Specify the default calendar for events under [calendar].
Default Reminder List: Set the default list for reminders under [reminder].
Default Notes Folder: Define the folder for notes under [notes].

Recent Updates (v0.16.22)

Refactored utility functions for improved clarity and maintainability
Enhanced calendar extraction in NLP commands
Improved time parsing for relative dates
Fixed edge cases in time parsing for specific date formats
Improved stability in WebSocket connections for API integrations

Full Changelog

Your Personal TimeAI