{"id":18453,"library":"jinzd-ai-cli","title":"jinzd-ai-cli","description":"Cross-platform AI CLI assistant that operates as a REPL-style terminal, Web UI, and desktop app. Supports 8 providers (Claude, Gemini, DeepSeek, OpenAI, GLM, Kimi, OpenRouter, and local Ollama) with Agentic tool calling (bash, file I/O, code search, web scraping, test running), prompt caching, batch API support, symbolic indexing (tree-sitter), semantic code search, MCP server mode, session memory, and sensitive data redaction. Requires Node.js >= 20, ESM-only. Active development, frequent releases.","status":"active","version":"0.4.96","language":"javascript","source_language":"en","source_url":"https://github.com/jinzhengdong/ai-cli","tags":["javascript","ai","cli","claude","gemini","deepseek","kimi","chatbot","repl"],"install":[{"cmd":"npm install jinzd-ai-cli","lang":"bash","label":"npm"},{"cmd":"yarn add jinzd-ai-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add jinzd-ai-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is a CLI tool, not a library. It is intended to be used via command line, not imported programmatically.","wrong":"trying to import as a library module","symbol":"aicli","correct":"example: run `aicli` from command line after global install"},{"note":"The package registers a global binary `aicli`. Use `npm install -g jinzd-ai-cli` then run `aicli`.","wrong":"using `npx jinzd-ai-cli` (works but not recommended)","symbol":"aicli (as binary)","correct":"npm install -g jinzd-ai-cli and then `aicli` in terminal"},{"note":"The desktop app is distributed as a standalone executable from GitHub Releases. Not installed via npm.","wrong":"Trying to run via `npm start` or node require","symbol":"Electron desktop app","correct":"Download from GitHub Releases, no Node.js needed"}],"quickstart":{"code":"npm install -g jinzd-ai-cli\n# Set API key (example for Claude)\nexport ANTHROPIC_API_KEY=sk-ant-...\n# Set preferred provider (optional, defaults to Claude)\nexport AI_PROVIDER=anthropic\n# Run REPL\n# aicli\n# Single prompt (headless mode)\naicli -p \"Explain what this package does in one sentence.\"\n# Start web UI\naicli web\n# For local models (Ollama): start REPL, then /provider ollama","lang":"bash","description":"Install globally, set an API key, and run the CLI in REPL mode, headless mode, or web UI."},"warnings":[{"fix":"Upgrade Node.js to version 20 or higher.","message":"Node.js >= 20 required. Older versions will not work.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Set the appropriate environment variable or configure via /provider command.","message":"Must set at least one API key for a supported provider (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.) or use local Ollama.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use nvm or configure npm prefix to user directory, or use `npm install -g` with sudo.","message":"Global install may require 'sudo' on macOS/Linux if npm prefix is system-owned.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use ES module syntax or dynamic import() if using in a Node.js script.","message":"The package is ESM-only. Cannot be used with CommonJS require().","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Ensure port 3000 (or custom port via --port) is accessible.","message":"Web UI mode may require additional ports (default 3000) to be open on firewall.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Add exclusion for the executable in antivirus settings.","message":"Electron desktop app (Windows) may trigger antivirus false positives due to binary packaging.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'20':74 '8':25 'activ':78 'agent':38 'ai':3,8,83 'api':53 'app':23 'assist':10 'bash':41 'batch':52 'cach':51 'call':40 'chatbot':89 'claud':27,85 'cli':4,9,84 'code':44,61 'cross':6 'cross-platform':5 'data':70 'deepseek':29,87 'desktop':22 'develop':79 'esm':76 'esm-on':75 'file':42 'frequent':80 'gemini':28,86 'glm':31 'i/o':43 'index':56 'javascript':82 'jinzd':2 'jinzd-ai-c':1 'kimi':32,88 'local':35 'mcp':63 'memori':67 'mode':65 'node.js':73 'ollama':36 'openai':30 'openrout':33 'oper':12 'platform':7 'prompt':50 'provid':26 'redact':71 'releas':81 'repl':16,90 'repl-styl':15 'requir':72 'run':49 'scrape':47 'search':45,62 'semant':60 'sensit':69 'server':64 'session':66 'sitter':59 'style':17 'support':24,54 'symbol':55 'termin':18 'test':48 'tool':39 'tree':58 'tree-sitt':57 'ui':20 'web':19,46","created_at":"2026-04-25T07:38:19.326060+00:00","updated_at":"2026-04-25T07:38:19.326060+00:00","problems":[{"fix":"Run `npm install -g jinzd-ai-cli` and ensure npm global bin directory is in your PATH.","cause":"Global installation not in PATH or not installed.","error":"command not found: aicli"},{"fix":"This is a CLI tool, not a library. Use `aicli` command directly. For programmatic use, consider subprocess execution.","cause":"Trying to require() the package in a Node.js script instead of using CLI binary.","error":"Error: Cannot find module 'jinzd-ai-cli'"},{"fix":"Ensure Node.js >=20 is installed and available in PATH, or use the desktop app which bundles Node.","cause":"Node.js not installed or not in PATH when running standalone executable (Electron).","error":"ERR! ... Error: spawn node ENOENT"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"jinzd","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/jinzhengdong/ai-cli","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/jinzd-ai-cli","openapi_spec":null,"status_page":null,"smithery":null,"categories":["llm-agents","ai-ml","devops","http-networking","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-24","install_tag":null}}