# 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.

## Install

```bash
npx skillstore add easysoft/zentao-cli
```

## Metadata

- - Slug: easysoft-zentao-cli
- - Version: 1.0.0
- - Author: easysoft
- - GitHub username: easysoft
- - License: MIT
- - Repository: https://github.com/easysoft/zentao-skills/tree/main/skills/zentao-cli
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: safe
- - Quality score: 80
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/easysoft-zentao-cli
- - Manifest: https://skillstore.pages.dev/api/skills/easysoft-zentao-cli/manifest

## Capabilities

- Query ZenTao data: products, projects, executions, stories, bugs, tasks, test cases
- Create, update, and delete records across all ZenTao modules
- Execute workflow actions: resolve bugs, close stories, activate tasks
- Filter, sort, and paginate data with field selection
- Handle authentication and credential management automatically
- Provide intent recognition for common project management operations

## Use Cases

- 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.

## Prompt Templates

### 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
```

## Limitations

- Requires zentao-cli package installation on the system
- Needs access to a running ZenTao server instance
- Command construction depends on accurate intent parsing from user input

## 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

## Anti Patterns

- 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

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-04-27T06:19:45.702\+00:00
- - Summary: 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.

## Stats

- - Views: 80
- - Downloads: 2
- - Favorites: 1
- - Popularity score: 0