MCP-native command line interface for Z.AI capabilities: vision analysis, web search, web reader, and GitHub repo exploration.
Found this useful? Follow @nummanali for more AI tooling!
- Vision - Analyze images, screenshots, diagrams, charts, videos using GLM-4.6V
- Search - Real-time web search with domain and recency filtering
- Reader - Fetch and parse web pages to markdown
- Repo - Search and read GitHub repository code via ZRead
- Tools - MCP tool discovery, schemas, and raw calls
- Code Mode - TypeScript tool chaining for agent automation
export Z_AI_API_KEY="your-api-key"
npx zai-cli --help
npx zai-cli vision analyze ./screenshot.png "What errors do you see?"
npx zai-cli search "React 19 new features" --count 5Get your API key at: https://z.ai/manage-apikey/apikey-list
OpenSkills (universal - works with any AI coding agent):
npx openskills install numman-ali/zai-cliClaude Code (native skill marketplace):
claude skill install numman-ali/zai-cli --skill zai-clinpm i -g zai-cli
zai-cli --helpOr use directly with npx:
npx zai-cli --helpThe CLI is self-documenting. Use --help at any level:
zai-cli --help # All commands
zai-cli vision --help # Vision commands
zai-cli search --help # Search options
zai-cli repo --help # GitHub repo commands# Vision - analyze images
zai-cli vision analyze ./image.png "Describe this"
zai-cli vision ui-to-code ./design.png --output code
zai-cli vision extract-text ./screenshot.png --language python
zai-cli vision diagnose-error ./error.png
# Search - web search
zai-cli search "TypeScript best practices" --count 10
zai-cli search "security news" --recency oneDay
# Reader - fetch web content
zai-cli read https://docs.example.com/api
zai-cli read https://blog.example.com --format text
# Repo - GitHub exploration
zai-cli repo tree facebook/react
zai-cli repo search vercel/next.js "app router"
zai-cli repo read anthropics/anthropic-sdk-python README.md
# Doctor - check setup
zai-cli doctorDefault output is data-only for token efficiency. Use --output-format json for structured responses:
{
"success": true,
"data": "...",
"timestamp": 1234567890
}├── packages/zai-cli/ # npm package source
├── skills/zai-cli/ # Agent skill (SKILL.md)
└── .claude-plugin/ # Claude Code marketplace config
cd packages/zai-cli
npm install
npm run build
npm testSee CONTRIBUTING.md for development setup and guidelines.
MIT - see LICENSE.