Zentao Cli

A command-line interface for ZenTao, the open source project management system popular in China. This wraps the entire ZenTao API into a CLI that handles authentication, pagination, and workspace context automatically. You can query and manipulate programs, products, projects, sprints, stories, bugs, tasks, test cases, releases, and feedback without touching the web UI. The skill covers typical PM workflows like creating bugs, resolving tickets, updating story status, and filtering task lists. Useful if your team runs ZenTao and you want to script repetitive operations or build automation around project data. The implementation auto-fills unchanged fields on updates to avoid accidentally clearing data, which is a nice touch given ZenTao's PUT behavior.

skills.sh installs: 764
GitHub stars: 77
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add easysoft/zentao-skills --skill zentao-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

禅道 CLI

用当前安装版本的离线帮助操作禅道；先执行 zentao --version 和 zentao help。此技能对应显式资源/动作命令树；旧版本需先确认其支持的命令。

身份与授权

优先复用已有凭据，不读取或打印密码、Token、凭据文件或环境变量值。用户已明确站点、对象和操作时直接执行；只要求查询或分析时不写入。

zentao auth status --format=json
zentao auth status --verify --format=json
zentao profile list --format=json
zentao profile use 'admin@https://zentao.example.com'

auth status 离线返回来源、站点、账号、凭据类型及 verified=false；--verify 才在线验证。认证优先级为显式 --profile → 完整环境凭据 → 默认 Profile；环境凭据缺一部分会直接报错，不会静默访问其他站点。简写账号有歧义时使用返回的完整 key。

缺少凭据时，Agent 可发起 zentao auth login --web 并保持进程运行，让用户在本机浏览器完成验证；不要在对话中收集密码。--no-input 明确禁止所有交互，包括浏览器。终端交互使用 zentao auth login --no-browser。远程运行时链接属于 CLI 执行端。

登录默认只保存凭据，不改变默认账号；随后使用 profile use，或业务命令显式 --profile。明确需要登录后选中账号时使用 auth login --select；由宿主打开浏览器链接时使用 auth login --web --no-open。自动化环境提供 ZENTAO_URL + ZENTAO_ACCOUNT + ZENTAO_TOKEN 或 ZENTAO_PASSWORD，同源 Token 优先。完整环境凭据不读取本地 Profile；只有明确要求保存环境登录时使用 auth login --use-env。

auth status --verify 使用已保存 Token 时只查询一次当前用户会话；失败不修改本地凭据。auth logout --revoke 撤销并核实远端会话后才删除本地记录；失败时保留记录供重试。--all 清理当前配置文件的全部账号，空配置也成功，不影响其他配置文件。

SKILL.md on GitHub