Zai CLI

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工具链

快速开始

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编码代理）：

npx openskills install numman-ali/zai-cli

克劳德代码 （本土技能市场）：

claude skill install numman-ali/zai-cli --skill zai-cli

作为CLI工具

npm i -g zai-cli
zai-cli --help

或者直接与npx一起使用：

npx zai-cli --help

用法

CLI是自文档化的。使用 --help 在任何级别：

zai-cli --help              # All commands
zai-cli vision --help       # Vision commands
zai-cli search --help       # Search options
zai-cli repo --help         # GitHub repo commands

例子

# 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 对于结构化响应：

{
  "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

发展

cd packages/zai-cli
npm install
npm run build
npm test
node scripts/bench-tools.mjs

贡献

看 贡献.md 用于开发设置和指南。

许可证

麻省理工学院-见 许可证.

链接

• OpenSkills