ticktick-cli_skill

Overview

This skill provides a Python command-line interface to interact with the Dida365 Open API for managing TickTick-style projects and tasks. It is built for scriptable, automatable workflows where you need to query, create, update, complete, or delete projects and tasks from the command line. The CLI expects to be executed from its folder and returns JSON output for easy parsing.

How this skill works

The script reads local configuration, calls the Dida365 Open API, and exposes project and task operations as subcommands. All commands support a --json flag so responses are emitted as structured JSON for pipelines or scripts. Use each subcommand's --help to discover available parameters and consult the bundled Open API reference for full field definitions.

When to use it

• Automating task creation or bulk updates from CI/CD or cron jobs
• Running quick task or project queries from a shell or terminal
• Building higher-level scripts that integrate TickTick data with other services
• Recovering or migrating tasks by exporting and re-creating items via CLI
• Triggering task completion or status changes from external tools or keyboard shortcuts

Best practices

• Always run the CLI from its skill folder to ensure correct working directory and config loading
• Use the --json flag for machine-readable output when chaining commands or scripting
• Test destructive operations (delete) on a safe project before running against real data
• Prefer explicit IDs (--project-id, --task-id) to avoid ambiguity when updating or deleting
• Use --help on any command to inspect optional/advanced fields before invoking it

Example use cases

• List all projects: run project list and parse the JSON to build a dashboard
• Create a task from an automation: task create --project-id <id> --title 'Deploy release' --due-date 2026-04-01
• Mark tasks complete from a script: task complete --project-id <id> --task-id <id> when a pipeline succeeds
• Bulk-update metadata: iterate projects and call project update --project-id <id> --color <value>
• Export a project's aggregated data: project data --project-id <id> to obtain project, open tasks, and column info