{"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,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","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,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}