ZAI CLI
MCP-native command line interface for Z.AI capabilities: vision analysis, web search, web reader, and GitHub repo exploration.
> 觉得这个有用吗? 跟随 @努曼纳里 更多AI工具!
特性
- 视觉 -使用GLM-4.6V分析图像、屏幕截图、图表、图表、视频
- 搜索 -基于域和最近度过滤的实时网络搜索
- 读者 -获取并解析网页以标记
- 仓库 -通过ZRead搜索和阅读GitHub存储库代码
- 工具 -MCP工具发现、模式和原始调用
- 代码模式 -用于代理自动化的TypeScript工具链
快速开始```bash
export Z_AI_API_KEY="your-api-key"
npx zai-cli --help
npx zai-cli vision analyze ./screenshot.png "What errors do you see?"
npx zai-cli search "React 19 new features" --count 5
获取API密钥:https://z.ai/manage-apikey/apikey-list
## 安装
### 作为代理技能
**OpenSkills** (通用-适用于任何AI编码代理):```bash
npx openskills install numman-ali/zai-cli
克劳德代码 (本土技能市场):```bash
claude skill install numman-ali/zai-cli --skill zai-cli
### 作为CLI工具```bash
npm i -g zai-cli
zai-cli --help
或者直接与npx一起使用:```bash
npx zai-cli --help
## 用法
CLI是自文档化的。使用 `--help` 在任何级别:```bash
zai-cli --help # All commands
zai-cli vision --help # Vision commands
zai-cli search --help # Search options
zai-cli repo --help # GitHub repo commands
例子```bash
Vision - analyze images
zai-cli vision analyze ./image.png "Describe this"
zai-cli vision ui-to-code ./design.png --output code
zai-cli vision extract-text ./screenshot.png --language python
zai-cli vision diagnose-error ./error.png
Search - web search
zai-cli search "TypeScript best practices" --count 10
zai-cli search "security news" --recency oneDay
Reader - fetch web content
zai-cli read https://docs.example.com/api
zai-cli read https://blog.example.com --format text
Repo - GitHub exploration
zai-cli repo tree facebook/react
zai-cli repo search vercel/next.js "app router"
zai-cli repo read anthropics/anthropic-sdk-python README.md
zai-cli repo search openai/codex "config" --language en
zai-cli repo tree openai/codex --path codex-rs --depth 2
Doctor - check setup
zai-cli doctor
zai-cli doctor --no-vision
## 输出格式
默认输出为 **仅限数据** 为了提高代币效率。使用 `--output-format json` 对于结构化响应:```json
{
"success": true,
"data": "...",
"timestamp": 1234567890
}
备注
repo search默认为英文结果。使用--language zh对于中国人来说。repo tree支持--path(目录范围)和--depth(展开子树)。tools,tool,call,doctor接受--no-vision在不需要视觉工具时加快启动速度。read支持--with-images-summary,--no-gfm,以及--keep-img-data-url以获得更丰富的解析控制。- 视觉工具调用会自动重试短暂的5xx/网络错误(默认值:2次重试)。配置为
ZAI_MCP_VISION_RETRY_COUNT(或ZAI_MCP_RETRY_COUNT所有工具)。 - 可以缓存工具发现以加快速度
tools/tool/doctor(默认:开启,24小时TTL)。配置为ZAI_MCP_TOOL_CACHE,ZAI_MCP_TOOL_CACHE_TTL_MS,ZAI_MCP_CACHE_DIR.
仓库的规划```
├── packages/zai-cli/ # npm package source
├── skills/zai-cli/ # Agent skill (SKILL.md)
└── .claude-plugin/ # Claude Code marketplace config
## 发展```bash
cd packages/zai-cli
npm install
npm run build
npm test
node scripts/bench-tools.mjs
贡献
看 贡献.md 用于开发设置和指南。
许可证
麻省理工学院-见 许可证.
链接
- npm包
- OpenSkills
