zai-cli

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 numman.ali@gmail.com

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 doctor to verify setup
Use npx zai-cli --help to see available commands
Try basic commands like vision, search, read, or repo
Use --help on 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.