ticktick

What This Skill Does

The TickTick CLI skill for OpenClaw provides a powerful, terminal-centric interface for managing your productivity lifecycle. It abstracts complex OAuth2 handshakes and API interactions into simple, human-readable commands. Whether you are automating routine administrative tasks or managing a professional workflow, this tool bridges the gap between your local terminal and your cloud-synced task lists, enabling rapid task creation, project filtering, and status management.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/norickkevorkov/ticktick-cli

Ensure you have your environment configured with bun installed, as this skill relies on the Bun runtime for execution. After installation, you must visit the TickTick Developer Center to generate your API credentials. Once obtained, initiate the authentication flow using bun run scripts/ticktick.ts auth --client-id YOUR_ID --client-secret YOUR_SECRET to link your account securely.

Use Cases

This skill is ideal for developers and power users who prefer keyboard-driven workflows. Common use cases include:

• Automating ticket creation from commit hooks or CI logs.
• Rapid task capture during focus sessions without context switching to a browser.
• Bulk management of project-specific task lists for team synchronization.
• Integrating TickTick task status into custom CLI dashboards or shell status lines.

Example Prompts

1. "Check my 'Work' list and tell me if I have any urgent tasks due today."
2. "Add a new task 'Submit Q4 Audit' to the 'Finance' project with high priority and tag it as 'finance' and 'urgent'."
3. "Find the task 'Update Documentation' and mark it as complete."

Tips & Limitations

• Manual Auth: If you are running this on a remote server or a headless environment, always utilize the --manual flag during the authentication process.
• Rate Limiting: The skill includes internal mechanisms to handle API rate limits, but avoid rapid, high-frequency scripting to ensure consistent API performance.
• Storage: Sensitive OAuth tokens are stored locally in ~/.clawdbot/credentials/ticktick-cli/config.json. Ensure this file maintains restricted system permissions on shared machines.