Metadata-Version: 2.5
Name: zen-cli
Version: 0.1.19
Summary: CLI for Zen Cloud Service. Designed for AI and Human.
Project-URL: Homepage, https://pypi.org/project/zen-cli/
Author: zen-cli authors
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.14
Requires-Dist: authlib>=1.3
Requires-Dist: click>=8.1
Requires-Dist: httpx2>=2
Requires-Dist: mcp>=2
Requires-Dist: packaging>=23
Requires-Dist: portalocker[win32]>=2.8
Requires-Dist: pydantic>=2
Requires-Dist: pyjwt>=2.8
Requires-Dist: python-dotenv>=1
Requires-Dist: pyyaml>=6
Requires-Dist: questionary>=2
Requires-Dist: rich-click>=1.8
Requires-Dist: tabulate>=0.9
Requires-Dist: yumako>=0.1.42
Description-Content-Type: text/markdown

# zen-cli

[![PyPI](https://img.shields.io/pypi/v/zen-cli?logo=pypi&logoColor=white)](https://pypi.org/project/zen-cli/) [![Python](https://img.shields.io/badge/python-3.14%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![PyPI downloads](https://img.shields.io/pypi/dm/zen-cli)](https://pypi.org/project/zen-cli/) [![Wheel](https://img.shields.io/pypi/wheel/zen-cli)](https://pypi.org/project/zen-cli/) [![OS](https://img.shields.io/badge/OS-macOS%20%7C%20Linux%20%7C%20Windows-informational)](https://pypi.org/project/zen-cli/) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![Checked with mypy](https://img.shields.io/badge/mypy-checked-2A6DB2)](https://mypy-lang.org/)

面向 AI 和人的 Zen Cloud 命令行工具。

![demo](docs/demo.gif)

## 使用

### 前置条件

* Python 3.14+
* [uv](https://docs.astral.sh/uv/) 或 [pipx](https://pipx.pypa.io/)

### 安装

```bash
uv tool install zen-cli --upgrade --python 3.14
```

或：

```bash
pipx install --upgrade zen-cli --python 3.14 --fetch-python missing
```

装完后若找不到 `zen`，跑 `uv tool update-shell` 或 `pipx ensurepath`，然后开一个新终端。Windows 同样适用。


### 使用 CLI

```bash
# 登录
zen auth login

# 跑一条命令，例如列出桌面池：
zen daas pool list

# 以可读方式输出
zen daas pool list -otable

# 更新
zen upgrade
```



## 文档

* [用户指南](docs/用户指南.md) — 鉴权、旗标、请求体和命令约定
* [资源与意图](docs/资源与意图.md) — 名词、身份、从属、允许的意图
* [配置](docs/配置.md) — 优先级、profile、features、环境变量
* [速查](docs/速查.md) — 命令示例
* [开发指南](docs/开发指南.md) — 环境、`./dev` / `dev.cmd`、如何加命令
* [CLI UX原则](docs/CLI UX原则.md) — 退出码、输出格式、通用参数和特例
* [架构原则](docs/架构原则.md) — 意图与资源、包划分和导入方向
* [Changelog](CHANGELOG.md) — 版本记录

## 许可证

采用 MIT License。见 [LICENSE](LICENSE)。
