Configuration with config.toml

The config.toml file is used to manage DuckTape's settings, including enabling natural language processing, setting default calendars, and more. This guide explains how to configure the file and provides examples for common use cases.

Example Configuration

[language_model]
provider = "OpenAI"  # Options: "OpenAI", "Grok", "DeepSeek", 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

DuckTape supports two modes of operation:

• Terminal Mode: Leave the provider field under [language_model] 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].

Advanced Configuration

For advanced use cases, you can add additional fields to the config.toml file. Refer to the DuckTape documentation for more details.