Help us improve
Share bugs, ideas, or general feedback.
From zai-cli
CLI for Z.AI: analyze images/videos (OCR, UI-to-code, errors), search web/GitHub repos, extract page markdown, discover/call MCP tools, chain TypeScript tools. For visual debugging, research.
npx claudepluginhub numman-ali/n-skills --plugin zai-cliHow this skill is triggered — by the user, by Claude, or both
Slash command
/zai-cli:zai-cliThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Access Z.AI capabilities via `npx zai-cli`. The CLI is self-documenting - use `--help` at any level.
Executes z.AI CLI for image/video analysis, OCR, UI-to-code conversion, web search, page extraction to markdown, and GitHub repo exploration. Requires Z_AI_API_KEY.
Guides when to use MCP tools over basic tools (Read/Grep/Glob/Bash) for semantic search, AI analysis, research, and image generation. Enforces the search_tools → get_tool_schema → execute_code workflow.
Generates invocations for ferris-search MCP tools like web_search, fetch_web_content, fetch_github_readme, and domain-specific article fetchers. Explains tool usage, parameters, and troubleshooting.
Share bugs, ideas, or general feedback.
Access Z.AI capabilities via npx zai-cli. The CLI is self-documenting - use --help at any level.
export Z_AI_API_KEY="your-api-key"
Get a key at: https://z.ai/manage-apikey/apikey-list
| 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 |
# 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
Default: data-only (raw output for token efficiency).
Use --output-format json for { success, data, timestamp } wrapping.
For raw MCP tool calls (tools, tool, call), Code Mode, and performance tuning (cache/retries),
see references/advanced.md.