| name | zai-cli |
|---|---|
| description | Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY. |
| allowed-tools | Read, Write, Edit, Bash(cmd:*), WebFetch |
| version | 1.0.0 |
| license | Apache-2.0 |
| author | Numman Ali <[email protected]> |
Zai Cli
Overview
ZAI CLI provides access to Z.AI capabilities including image/video analysis, real-time web search, web page extraction, and GitHub code exploration. It integrates with Claude Code via MCP protocol for seamless AI-powered content analysis.
Prerequisites
- Node.js 18+ installed
- Z_AI_API_KEY environment variable set
- API key from https://z.ai/manage-apikey/apikey-list
- Network access to Z.AI API endpoints
Instructions
- Obtain an API key from Z.AI platform
- Export your API key:
export Z_AI_API_KEY="your-key" - Run
npx zai-cli doctorto verify setup - Use
npx zai-cli --helpto see available commands - Try basic commands like vision, search, read, or repo
- Use
--helpon any subcommand for detailed options
Access Z.AI capabilities via npx zai-cli. The CLI is self-documenting - use --help at any level.
Output
Default: data-only (raw output for token efficiency).
Use --output-format json for { success, data, timestamp } wrapping.
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.