Todoist via td CLI

What This Skill Does

The Todoist skill leverages the td command-line interface (CLI) to seamlessly integrate with your Todoist account, allowing you to manage your tasks directly from the terminal. This skill enables you to view your agenda, including overdue, today's, and upcoming tasks, as well as manage your inbox. You can list projects, labels, and tasks, add new to-dos with natural language, and perform various updates such as modifying task content, descriptions, due dates, priorities, and labels. It also supports completing, reopening, and deleting tasks, with appropriate confirmation for destructive actions.

Installation

To use the Todoist skill, you first need to install the td CLI. Follow these steps:

1. Clone the repository:

   git clone https://github.com/Doist/todoist-cli
   cd todoist-cli
   

2. Install dependencies and build:

   npm install
   npm run build
   

3. Link the CLI globally:

   npm link
   

4. Verify the installation:

   td --help
   

For optimal integration, especially when parsing output, it's recommended to use the --json or --ndjson flags with td commands for listing and reading tasks.

Use Cases

This skill is designed for users who prefer managing their to-do lists directly from their terminal. It streamlines various aspects of task management:

• Quick Agenda Review: Get an immediate overview of overdue, today's, and upcoming tasks.
• Task Listing: View tasks in your inbox, by project, or by label.
• Task Creation: Add new tasks quickly using natural language, specifying details like due dates, times, priorities, and projects in a single command.
• Task Modification: Update existing tasks by changing their content, adding notes or descriptions, adjusting due dates, setting priorities (p1-p4), or assigning labels. You can reference tasks by their ID or by searching for them.
• Task Completion/Deletion: Mark tasks as complete or delete them (with a confirmation prompt for safety).

Example Prompts

• "What are my overdue and today's tasks?"
• "Add a task to buy groceries for tomorrow at 5 PM and mark it as important."
• "Update the task 'Call the bank' to include their phone number 555-1234 in the description and set the due date to next Monday."

Tips & Limitations

• Task Identification: For editing or deleting tasks, it's most reliable to use the task ID (e.g., id:6WcqCcR4wF7XW5m6). If you only have a title, the skill will search for it, but ambiguities might require user clarification.
• Natural Language: The td CLI's natural language parsing for adding and updating tasks is powerful but has its limits. Complex or ambiguous requests might not be interpreted as intended.
• Output Parsing: Always prefer JSON output (--json or --ndjson) when the td command supports it for more reliable parsing by the AI agent.
• Destructive Actions: Deleting tasks requires explicit user confirmation to prevent accidental data loss.
• Data Entry: When adding information like phone numbers to a task, it will be placed in the task's description field unless the user specifically requests it in the title.
• Dependencies: Requires Node.js and npm to be installed for the td CLI.