Latest release v0.2.7

DidaCLI

JSON-first CLI for Dida365 and TickTick task automation. Install it with npm, verify auth locally, and give scripts or agents a stable command surface for tasks, projects, schemas, and upgrades.

Start with npm Command reference npm package
terminal 
$ npm install -g @delicious233/dida-cli
$ dida auth cookie set --token-stdin --json
$ dida doctor --verify --json
{ "ok": true, "command": "doctor" }

$ dida schema list --compact --json
$ dida task latest --limit 10 --project inbox --compact --json
$ dida completion bash

Install, verify, read.

The npm package downloads the matching GitHub Release binary during postinstall. Keep cookies out of shell history by importing them through stdin.

Quickstart Agent usage README Security
  1. 1

    Install

    npm install -g @delicious233/dida-cli

  2. 2

    Add local auth

    dida auth cookie set --token-stdin --json

  3. 3

    Verify the account channel

    dida doctor --verify --json

  4. 4

    Discover and read

    dida schema list --compact --json and dida task latest --limit 10 --project inbox --compact --json

Current command surface.

DidaCLI keeps auth channels separate: Web API cookie auth, Official MCP token auth, and Official OpenAPI OAuth. Each command advertises its auth requirement in the schema index.

Stable JSON for automation

Use --json for a consistent envelope with ok, command, meta, data, and error.

Compact reads for agents

dida task latest --limit 10 --project inbox --compact --json returns recent active tasks without large raw fields.

Schema before writes

dida schema list --compact --json and dida schema show task.create --json explain dry-run support and destructive confirmation.

Shell completion

Generate scripts with dida completion bash, zsh, fish, or powershell.

Release-aware diagnostics

dida doctor --check-upgrade --json reports the latest GitHub Release without installing an update.

Private-state guardrails

Token redaction, stdin secret import, dry-run writes, and explicit --yes confirmations are built into the CLI workflow.