jinzd-ai-cli

library0.4.96jsnpmunverified

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.

llm-agents ai-ml devops http-networking web-framework

npm install jinzd-ai-cli

github ↗package ↗

INSTALL

IMPORT

SIG · JINZD-AI-CLI

jinzd-ai-cli

llm-agentsjavascriptv0.4.96

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

aicli

✓ example: run `aicli` from command line after global install

✗ trying to import as a library module

This package is a CLI tool, not a library. It is intended to be used via command line, not imported programmatically.

aicli (as binary)

✓ npm install -g jinzd-ai-cli and then `aicli` in terminal

✗ using `npx jinzd-ai-cli` (works but not recommended)

The package registers a global binary `aicli`. Use `npm install -g jinzd-ai-cli` then run `aicli`.

Electron desktop app

✓ Download from GitHub Releases, no Node.js needed

✗ Trying to run via `npm start` or node require

The desktop app is distributed as a standalone executable from GitHub Releases. Not installed via npm.

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

jinzd --version

Debug

Known issues

breakingNode.js >= 20 required. Older versions will not work.

fix

Upgrade Node.js to version 20 or higher.

affects: >=0.0.0

gotchaMust 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.

affects: >=0.0.0

gotchaGlobal 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.

affects: >=0.0.0

gotchaThe 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.

affects: >=0.0.0

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

fix

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

affects: >=0.0.0

gotchaElectron desktop app (Windows) may trigger antivirus false positives due to binary packaging.

fix

Add exclusion for the executable in antivirus settings.

affects: >=0.0.0

Errors

Common errors & fixes

command not found: aicli

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: Cannot find module 'jinzd-ai-cli'

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.

ERR! ... Error: spawn node ENOENT

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.

Upgrade

Version history

0.4.96latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/jinzhengdong/ai-cli ↗

packagehttps://www.npmjs.com/package/jinzd-ai-cli ↗