← Back to Skills Marketplace
Ticktick Cli
by
Norickkevorkov
· GitHub ↗
· v1.0.0
1100
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ticktick-cli
Description
Manage TickTick tasks and projects from the command line with OAuth2 auth, batch operations, and rate limit handling.
Usage Guidance
This skill is functionally coherent with a TickTick CLI, but note two things before installing: (1) the skill and SKILL.md assume the Bun runtime (commands use 'bun run' and the main script has a bun shebang), yet the metadata does not list Bun as a required binary — make sure Bun is installed and that you trust running Bun scripts from this source. (2) OAuth tokens and your client secret are stored in plaintext at ~/.clawdbot/credentials/ticktick-cli/config.json (the code tries to set 700/600 perms but the file is still plaintext); treat this file as sensitive or consider storing credentials in a secure vault instead. Verify the skill's source/owner, and if you need stronger guarantees, inspect the included scripts locally before running them.
Capability Analysis
Type: OpenClaw Skill
Name: ticktick-cli
Version: 1.0.0
The OpenClaw AgentSkills skill bundle for TickTick CLI is benign. It provides a command-line interface to manage TickTick tasks and projects, using a standard OAuth2 authentication flow. Credentials (client ID/secret, access/refresh tokens) are stored locally in `~/.clawdbot/credentials/ticktick-cli/config.json` with explicit `chmod 0o600` permissions, which is a transparent and reasonable security practice for a CLI tool within the agent's designated storage. All network communication is directed to the legitimate `ticktick.com` API. The `SKILL.md` instructions are clear and guide the agent on effective usage without any prompt injection attempts to subvert the agent's purpose or security. No evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation was found.
Capability Assessment
Purpose & Capability
The code and SKILL.md match the stated purpose (TickTick task/project management via OAuth). However the skill's metadata declares no required binaries while the instructions and scripts use the Bun runtime (commands like 'bun run scripts/ticktick.ts' and a #!/usr/bin/env bun shebang). The absence of a declared required binary for Bun is an inconsistency that could cause confusion or unexpected behavior.
Instruction Scope
Runtime instructions and included code stay within the stated purpose: initiating OAuth with TickTick, calling TickTick API endpoints (api.ticktick.com), and providing task/project CRUD operations. The SKILL.md and code explicitly document where tokens are stored and how auth flows work. No instructions attempt to read unrelated system files or send data to external endpoints other than TickTick's OAuth/API hosts.
Install Mechanism
There is no install spec (instruction-only), but the package actually includes runnable source files and a package.json. The runtime assumes Bun is available; dependencies (commander, open) are standard Node-style deps. Nothing is downloaded from unknown URLs and no archive extraction occurs. Still, packaging as 'no install' while providing code that requires Bun is a packaging mismatch to be aware of.
Credentials
The skill asks for no environment variables and the only secrets required are the TickTick OAuth client ID/secret provided interactively or via CLI flags — which is appropriate for an OAuth-based CLI. There are not multiple unrelated credentials requested.
Persistence & Privilege
The CLI writes its own credentials to ~/.clawdbot/credentials/ticktick-cli/config.json and attempts to set restrictive permissions. It does not modify other skills or system-wide configuration. always:false and normal agent invocation are used.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ticktick-cli - After installation, invoke the skill by name or use
/ticktick-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Command-line client for managing TickTick tasks and projects.
- OAuth2 authentication with support for browser and headless/manual flows.
- List, create, update, complete, and abandon tasks.
- Batch abandonment of multiple tasks in a single API call.
- Manage projects: list, create, update (rename, change color).
- Supports JSON output for easy scripting and automation.
- Handles API rate limits and automatic token refresh.
- Comprehensive CLI documentation and troubleshooting tips included.
Metadata
Frequently Asked Questions
What is Ticktick Cli?
Manage TickTick tasks and projects from the command line with OAuth2 auth, batch operations, and rate limit handling. It is an AI Agent Skill for Claude Code / OpenClaw, with 1100 downloads so far.
How do I install Ticktick Cli?
Run "/install ticktick-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ticktick Cli free?
Yes, Ticktick Cli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Ticktick Cli support?
Ticktick Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ticktick Cli?
It is built and maintained by Norickkevorkov (@norickkevorkov); the current version is v1.0.0.
More Skills