jinzd-ai-cli

0.4.96 verified Sat Apr 25 auth: no javascript

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.

Common errors

error command not found: aicli ↓

cause Global installation not in PATH or not installed.

fix

Run npm install -g jinzd-ai-cli and ensure npm global bin directory is in your PATH.

error Error: Cannot find module 'jinzd-ai-cli' ↓

cause Trying to require() the package in a Node.js script instead of using CLI binary.

fix

This is a CLI tool, not a library. Use aicli command directly. For programmatic use, consider subprocess execution.

error ERR! ... Error: spawn node ENOENT ↓

cause Node.js not installed or not in PATH when running standalone executable (Electron).

fix

Ensure Node.js >=20 is installed and available in PATH, or use the desktop app which bundles Node.

Warnings

breaking Node.js >= 20 required. Older versions will not work. ↓

fix Upgrade Node.js to version 20 or higher.

gotcha Must set at least one API key for a supported provider (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.) or use local Ollama. ↓

fix Set the appropriate environment variable or configure via /provider command.

gotcha Global install may require 'sudo' on macOS/Linux if npm prefix is system-owned. ↓

fix Use nvm or configure npm prefix to user directory, or use `npm install -g` with sudo.

gotcha The package is ESM-only. Cannot be used with CommonJS require(). ↓

fix Use ES module syntax or dynamic import() if using in a Node.js script.

gotcha Web UI mode may require additional ports (default 3000) to be open on firewall. ↓

fix Ensure port 3000 (or custom port via --port) is accessible.

gotcha Electron desktop app (Windows) may trigger antivirus false positives due to binary packaging. ↓

fix Add exclusion for the executable in antivirus settings.

Install

npm install jinzd-ai-cli

yarn add jinzd-ai-cli

pnpm add jinzd-ai-cli

Imports

aicli
wrong
```
trying to import as a library module
```
correct
```
example: run `aicli` from command line after global install
```
This package is a CLI tool, not a library. It is intended to be used via command line, not imported programmatically.
aicli (as binary)
wrong
```
using `npx jinzd-ai-cli` (works but not recommended)
```
correct
```
npm install -g jinzd-ai-cli and then `aicli` in terminal
```
The package registers a global binary `aicli`. Use `npm install -g jinzd-ai-cli` then run `aicli`.
Electron desktop app
wrong
```
Trying to run via `npm start` or node require
```
correct
```
Download from GitHub Releases, no Node.js needed
```
The desktop app is distributed as a standalone executable from GitHub Releases. Not installed via npm.

Quickstart

Install globally, set an API key, and run the CLI in REPL mode, headless mode, or web UI.

npm install -g jinzd-ai-cli
# Set API key (example for Claude)
export ANTHROPIC_API_KEY=sk-ant-...
# Set preferred provider (optional, defaults to Claude)
export AI_PROVIDER=anthropic
# Run REPL
# aicli
# Single prompt (headless mode)
aicli -p "Explain what this package does in one sentence."
# Start web UI
aicli web
# For local models (Ollama): start REPL, then /provider ollama