# Manage TickTick Tasks from the Command Line

Managing TickTick data manually can interrupt automated workflows. This skill uses the official Open API to manage projects, tasks, focus records, and habits.

## Install

```bash
npx skillstore add dcjanus/ticktick-cli
```

## Metadata

- Status: approved
- Slug: dcjanus-ticktick-cli
- Skillstore revision: r2
- Version status: missing
- Tree hash: 59bbda5a3bab1cb696c91dd005c7e6b665a338b46c8b998bf61a9524d1d53c84
- Author: DCjanus
- GitHub username: DCjanus
- License: MIT
- Repository: https://github.com/DCjanus/prompts/tree/master/skills/ticktick-cli
- Ref: c43861a65bb95efcae259cd161c9d6f4dc7eec6f
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, filesystem, env\_access, scripts, external\_commands
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/dcjanus-ticktick-cli
- Manifest: https://skillstore.pages.dev/api/skills/dcjanus-ticktick-cli/manifest

## Capabilities

- Authenticate with Dida365 or TickTick through OAuth and a loopback callback.
- List, inspect, create, update, and delete projects.
- Create, update, complete, delete, move, and filter tasks with checklist items and tags.
- Get, list, and delete focus records by type and time range.
- List, create, update, and check in habits using structured fields or payload files.

## Use Cases

- Maintain a Personal Task Queue: Review active tasks, add due dates, complete finished work, and move tasks between projects.
- Automate Project Intake: Create projects and structured tasks from an approved workflow while preserving tags, priorities, and checklist items.
- Analyze Productivity Records: Retrieve focus sessions, completed tasks, habits, and check-ins for a selected reporting period.

## Prompt Templates

### List My Projects

```
List my TickTick projects. Return each project name and identifier. Do not change any data.
```

### Create a Structured Task

```
Create a task named [title] in project [project]. Set due date [date], priority [priority], tags [tags], and checklist [items].
```

### Review and Reorganize Work

```
Find incomplete tasks in project [source] with tag [tag]. Propose moves to project [destination], then wait for my approval before changing anything.
```

### Build a Productivity Summary

```
For [date range], compare completed tasks, focus sessions, and habit check-ins. Group results by project and highlight missing or inconsistent records.
```

## Limitations

- The CLI requires uv, Python 3.14 or newer, network access, and supported Open API availability.
- OAuth credentials are stored in a local token file and must be protected.
- Account region is selected during login and later inferred from stored token metadata.
- Delete operations have no CLI confirmation or undo support.

## Best Practices

- Use read-only list or get commands to verify identifiers before remote changes.
- Request JSON output when another tool or agent must parse the result.
- Confirm the exact target before every delete, move, complete, or bulk update operation.

## Anti Patterns

- Do not expose, print, or share the local OAuth token file.
- Do not infer a project or task identifier from a similar display name.
- Do not execute destructive operations from an ambiguous or indirect request.

## Security Audit

- Audited at: 2026-07-23T17:06:30.632\+00:00
- Summary: Most static findings are false positives caused by Markdown backticks, ordinary Python imports, error messages, official service URLs, and a plain-text Chinese document. The implementation has genuine risks from non-atomic token permissions, unpinned runtime dependencies, direct destructive commands, and disclosure of the local hostname during OAuth registration.

## Stats

- Views: 255
- Downloads: 11
- Favorites: 0
- Popularity score: 0