/zai-cli
Z.AI CLI providing: - Vision: image/video analysis, OCR, UI-to-code, error diagnosis (GLM-4.6V) - Search: real-time web search with domain/recency filtering - Reader: web page to markdown extraction - Repo: GitHub code search and reading via ZRead - Tools: MCP tool discovery and
$ npx -y skills add numman-ali/zai-cli --skill zai-cli --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/zai-cli
Context preview
The summary Claude sees to decide when to auto-load this skill.
Z.AI CLI providing: - Vision: image/video analysis, OCR, UI-to-code, error diagnosis (GLM-4.6V) - Search: real-time web search with domain/recency filtering - Reader: web page to markdown extraction - Repo: GitHub code search and reading via ZRead - Tools: MCP tool discovery and
SKILL.md
zai-cli.SKILL.mdname: zai-cli
description: |
Z.AI CLI providing:
- Vision: image/video analysis, OCR, UI-to-code, error diagnosis (GLM-4.6V)
- Search: real-time web search with domain/recency filtering
- Reader: web page to markdown extraction
- Repo: GitHub code search and reading via ZRead
- Tools: MCP tool discovery and raw calls
- Code: TypeScript tool chaining
Use for visual content analysis, web search, page reading, or GitHub exploration. Requires Z_AI_API_KEY.
ZAI CLI
Access Z.AI capabilities via `npx zai-cli`. The CLI is self-documenting - use `--help` at any level.
Setup
export Z_AI_API_KEY="your-api-key"
Get a key at: https://z.ai/manage-apikey/apikey-list
Commands
| Command | Purpose | Help | |---------|---------|------| | vision | Analyze images, screenshots, videos | `--help` for 8 subcommands | | search | Real-time web search | `--help` for filtering options | | read | Fetch web pages as markdown | `--help` for format options | | repo | GitHub code search and reading | `--help` for tree/search/read | | tools | List available MCP tools | | | tool | Show tool schema | | | call | Raw MCP tool invocation | | | code | TypeScript tool chaining | | | doctor | Check setup and connectivity | |
Quick Start
# Analyze an image
npx zai-cli vision analyze ./screenshot.png "What errors do you see?"
# Search the web
npx zai-cli search "React 19 new features" --count 5
# Read a web page
npx zai-cli read https://docs.example.com/api
npx zai-cli read https://docs.example.com/api --with-images-summary --no-gfm
# Explore a GitHub repo
npx zai-cli repo search facebook/react "server components"
npx zai-cli repo search openai/codex "config" --language en
npx zai-cli repo tree openai/codex --path codex-rs --depth 2
# Check setup
npx zai-cli doctor
Output
Default: **data-only** (raw output for token efficiency). Use `--output-format json` for `{ success, data, timestamp }` wrapping.
Advanced
For raw MCP tool calls (`tools`, `tool`, `call`), Code Mode, and performance tuning (cache/retries), see `references/advanced.md`.
Read more
name: zai-cli description: | Z.AI CLI providing: - Vision: image/video analysis, OCR, UI-to-code, error diagnosis (GLM-4.6V) - Search: real-time web search with domain/recency filtering - Reader: web page to markdown extraction - Repo: GitHub code search and reading via ZRead - Tools: MCP tool discovery and raw calls - Code: TypeScript tool chaining Use for visual content analysis, web search, page reading, or GitHub exploration. Requires Z_AI_API_KEY.
ZAI CLI
Access Z.AI capabilities via `npx zai-cli`. The CLI is self-documenting - use `--help` at any level.
Setup
export Z_AI_API_KEY="your-api-key"
Get a key at: https://z.ai/manage-apikey/apikey-list
Commands
| Command | Purpose | Help | |---------|---------|------| | vision | Analyze images, screenshots, videos | `--help` for 8 subcommands | | search | Real-time web search | `--help` for filtering options | | read | Fetch web pages as markdown | `--help` for format options | | repo | GitHub code search and reading | `--help` for tree/search/read | | tools | List available MCP tools | | | tool | Show tool schema | | | call | Raw MCP tool invocation | | | code | TypeScript tool chaining | | | doctor | Check setup and connectivity | |
Quick Start
# Analyze an image npx zai-cli vision analyze ./screenshot.png "What errors do you see?" # Search the web npx zai-cli search "React 19 new features" --count 5 # Read a web page npx zai-cli read https://docs.example.com/api npx zai-cli read https://docs.example.com/api --with-images-summary --no-gfm # Explore a GitHub repo npx zai-cli repo search facebook/react "server components" npx zai-cli repo search openai/codex "config" --language en npx zai-cli repo tree openai/codex --path codex-rs --depth 2 # Check setup npx zai-cli doctor
Output
Default: **data-only** (raw output for token efficiency). Use `--output-format json` for `{ success, data, timestamp }` wrapping.
Advanced
For raw MCP tool calls (`tools`, `tool`, `call`), Code Mode, and performance tuning (cache/retries), see `references/advanced.md`.
MCP-native command line interface for Z.AI capabilities: vision analysis, web search, web reader, and GitHub repo exploration.

