zentao (ZenTao CLI)

When to use this skill

Use this skill when the user asks anything about 禅道 / ZenTao, including:

bugs: list, mine, get, create, resolve, assign, comment, close, activate
tasks: list, get, create, start, finish, pause, close
stories: list, get, create
todos: list, get, create, finish, close
products, programs, projects, executions
plans, releases, builds
test cases, test tasks, test suites
docs and doc libraries
users and departments
issues and risks
login, whoami, self-test, JSON export

Typical user asks include:

“帮我查禅道 bug / task / story / todo”
“看一下产品、项目、执行、版本、计划、构建”
“查测试单、测试用例、测试套件”
“看文档库 / 文档 / 部门 / 用户”
“查问题 / 风险”
“帮我登录禅道” / “验证禅道连接”

Installation

bash

npx skills add leeguooooo/zentao-mcp -y -g
pnpm i -g @leeguoo/zentao-mcp

Fallbacks:

bash

npm i -g @leeguoo/zentao-mcp
npx -y @leeguoo/zentao-mcp --help

skills add

installs the skill definition; the CLI still needs to be available as

zentao

in PATH for normal usage.

Login

bash

zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami

IMPORTANT:

--zentao-url

usually must include

/zentao

Quick start

bash

zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
zentao self-test

Capability map

Use the singular command for one record or a state-changing action, and the plural command for list queries.

bash

zentao login
zentao whoami
zentao self-test
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bug get|create|resolve|assign|comment|close|activate ...
zentao tasks list --execution 25
zentao task get|create|start|finish|pause|close ...
zentao stories list --product 3
zentao story get|create ...
zentao todos list|get|create|finish|close ...
zentao plans list|get ...
zentao releases list|get ...
zentao testcases list|get ...
zentao testtasks list|get ...
zentao testsuites list|get ...
zentao docs libs|list|get ...
zentao users list
zentao departments list
zentao issues list|get ...
zentao risks list|get ...

Auth and output rules

All commands can read credentials from saved login config.

Flags also work:

--zentao-url

--zentao-account

--zentao-password

Environment variables also work:
```
ZENTAO_URL
```
,
```
ZENTAO_ACCOUNT
```
,
```
ZENTAO_PASSWORD
```
Add
```
--json
```
when the caller wants raw machine-readable output.
ZenTao URLs usually need the
```
/zentao
```
suffix.

Bug commands

bash

zentao bugs list --product 6
zentao bugs mine --scope assigned --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title" [--severity 3] [--pri 2] [--type codeerror] [--steps "..."] [--assigned-to account] [--opened-build trunk]
zentao bug resolve --id 1329 --resolution fixed [--resolved-build trunk] [--assigned-to kelly] [--comment "..."]
zentao bug assign --id 1329 --assigned-to rd-yitong [--comment "..."]
zentao bug close --id 1329 [--comment "..."]
zentao bug activate --id 1329 [--assigned-to account] [--comment "..."]
zentao bug comment --id 1329 --comment "已确认，等待修复"

Resolution values:

fixed

bydesign

duplicate

postponed

notrepro

willnotfix

tostory

external

Task commands

bash

zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name" [--assigned-to account] [--pri 3] [--estimate 8] [--type devel] [--desc "..."]
zentao task start --id 388 [--consumed 2] [--left 6]
zentao task finish --id 388 [--finished-date "2026-04-08"] [--consumed 8]
zentao task pause --id 388
zentao task close --id 388 [--comment "done"]

Story commands

bash

zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title" [--spec "description"] [--pri 2] [--estimate 3] [--type story] [--assigned-to account]

Todo commands

bash

zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name" [--type custom] [--date 2026-04-08] [--begin 09:00] [--end 10:00] [--pri 3] [--desc "..."] [--assigned-to account]
zentao todos finish --id 1
zentao todos close --id 1

Product, program, project, and execution commands

bash

zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list

Product plans and releases

bash

zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1

Testing commands

bash

zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1

Organization & docs

bash

zentao users list
zentao departments list
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1

Issues & risks

bash

zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1

JSON output

All commands support

--json

for full JSON payload:

bash

zentao whoami --json
zentao bugs list --product 6 --json
zentao task get --id 388 --json
zentao users list --json
zentao issues get --id 1 --json

Recommended execution pattern

When helping a user operationally, prefer this sequence:

Ensure CLI exists:
```
zentao --help
```
Ensure auth exists:
```
zentao whoami
```
If auth may be broken, run:
```
zentao self-test
```
Use the narrowest command that answers the request.
Add
```
--json
```
when the caller needs structured output for follow-up automation.

zentao

NPX Install

Tags

SKILL.md Content

zentao (ZenTao CLI)

When to use this skill

Installation

Login

Quick start

Capability map

Auth and output rules

Bug commands

Task commands

Story commands

Todo commands

Product, program, project, and execution commands

Product plans and releases

Testing commands

Organization & docs

Issues & risks

JSON output

Recommended execution pattern