Skills zentao-cli
📦

zentao-cli

Safe

Integrate ZenTao project management via CLI

Access and manage ZenTao project data through natural language commands. Claude handles authentication, data queries, and task operations using the zentao CLI tool.

Supports: Claude Codex Code(CC)
🥉 73 Bronze
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "zentao-cli". List all active bugs in product #1

Expected outcome:

Showing 12 active bugs in Product #1:

| ID | Title | Severity | Priority | Status | Assigned To |
|----|-------|----------|----------|--------|-------------|
| 42 | Login page timeout | 2 | 2 | active | admin |
| 45 | Data export fails | 3 | 2 | active | dev_user |

...

Using "zentao-cli". Create a new task

Expected outcome:

Task created successfully:

- ID: 156
- Name: Implement user profile feature
- Execution: Sprint #3
- Assigned to: developer@company.com
- Estimate: 8 hours
- Status: wait

Using "zentao-cli". Resolve bug #42

Expected outcome:

Bug #42 has been resolved:

- Resolution: fixed
- Resolved By: admin
- Resolved Date: 2024-04-27
- Build: trunk

Security Audit

Safe
v1 • 4/27/2026

This is a legitimate project management CLI documentation file. The static analyzer flagged 96 instances of 'external_commands' but all are FALSE POSITIVES - they are example commands shown in markdown documentation blocks, not actual code execution. No malicious intent, prompt injection, or security threats found after human evaluation.

1
Files scanned
260
Lines analyzed
0
findings
1
Total audits
No security issues found
Audited by: claude

Quality Score

38
Architecture
100
Maintainability
87
Content
50
Community
100
Security
83
Spec Compliance

What You Can Build

Query project and bug status

Project managers ask for project progress, active bugs, or task summaries. Claude queries ZenTao and presents data in readable format.

Create and update tasks via chat

Developers create tasks, log work time, and update issue statuses through conversation. Claude translates requests into zentao CLI commands.

Bulk operations and data retrieval

QA teams retrieve test case lists, create test tasks, and track testing progress. Claude handles pagination and field selection automatically.

Try These Prompts

List active projects
Show me all active projects in ZenTao with their current status and progress
Create and assign task
Create a new task in execution #5 with title 'Fix login bug', assigned to admin, estimated 4 hours
Resolve bug with confirmation
I want to resolve bug #42. Please confirm the command and then execute it with --yes flag
Complex data query with filters
Find all high-priority bugs in product #3 that are still open, sorted by severity, showing only id, title, and assignedTo fields

Best Practices

  • Start with listing commands to discover IDs before making updates
  • Use --pick parameter to show only relevant fields in output
  • Include --yes flag for destructive operations to skip confirmation prompts

Avoid

  • Do not execute write operations (create/update/delete) without user confirmation
  • Avoid running commands with unknown IDs - always verify existence first
  • Do not skip error handling - check for E1001 (not logged in) and E2002 (object not found) codes

Frequently Asked Questions

How do I install zentao-cli?
Run npm install -g zentao-cli, or use bun/pnpm: bun install -g zentao-cli. You can also run it without installing: npx zentao-cli
How does authentication work?
Run zentao login -s https://your-zentao.com -u username -p password. Credentials are cached in ~/.config/zentao/zentao.json for subsequent use.
What modules are supported?
All major modules: program, product, project, execution, story, bug, task, testcase, testtask, productplan, build, release, feedback, ticket, user, and file.
How do I handle write operations safely?
Always confirm the operation with the user before executing create, update, or delete commands. Use --yes flag only when user explicitly requests it.
What format does output use?
Default output is Markdown tables for lists and plain text for single items. Use --format=json for structured data when needed.
How do I resolve common errors?
E1001/E1004 means credentials expired - run zentao login again. E2002 means object not found - verify the ID. E2003 means missing parameters - run zentao <module> help for guidance.

Developer Details

File structure

📄 SKILL.md