Skip to content
Research
Skill

/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

BOOST
From plugin
zai-cli
1101 skill
Install
$ npx -y skills add numman-ali/zai-cli --skill zai-cli --agent claude-code

How 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.md
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`.

Read more
Ships withzai-cli

MCP-native command line interface for Z.AI capabilities: vision analysis, web search, web reader, and GitHub repo exploration.

Get the whole plugin
Stats
110
Stars
13
Forks
Quiet
Maintenance
TypeScript
Language
MIT
License
9mo ago
Last commit
10mo ago
Created
1d ago
Added

Repo: numman-ali/zai-cli