vedadb-cli

library5.0.0jsnpmunverified

VedaDB CLI is a MySQL-style interactive command-line SQL shell for VedaDB, a multi-model database supporting SQL, vector, graph, and full-text search. Version 5.0.0 is the current stable release with no fixed release cadence. Key differentiators include colorized output, auto-suggest, AI agent integration (Ollama/OpenAI), and MySQL-compatible syntax. It supports vector similarity search via SQL and connects to local or remote VedaDB instances. Unlike generic db-clients, it is purpose-built for VedaDB's hybrid features.

database

npm install vedadb-cli

package ↗

INSTALL

IMPORT

SIG · VEDADB-CLI

vedadb-cli

databasejavascriptv5.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installs VedaDB CLI globally and connects to a local VedaDB server with host, port, username, and password.

npm install -g vedadb-cli vedadb-cli -h localhost -P 6380 -u admin -p secret

Debug

Known issues

breakingVedaDB CLI v5 requires Node.js >=16.0.0. Older versions will fail to install or run.

fix

Upgrade Node.js to >=16.0.0.

affects: <5.0.0

deprecatedThe --password flag is deprecated in v5. Use the -p short flag or environment variable VEDADB_PASSWORD.

fix

Use -p <password> or set VEDADB_PASSWORD environment variable.

affects: <5.0.0

gotchaWhen connecting to a remote VedaDB instance, the host must be explicitly set to an IP or FQDN. Defaults to localhost.

fix

Specify -h <ip_or_fqdn> when connecting remotely.

affects: >=5.0.0

breakingThe AI agent feature (--ai) requires either Ollama or OpenAI credentials. Missing configuration causes command failure.

fix

Set OLLAMA_HOST or OPENAI_API_KEY environment variable before using --ai flag.

affects: >=5.0.0

gotchaMulti-line queries require a trailing semicolon to execute. Missing semicolon results in continuation prompt.

fix

End SQL statements with a semicolon to execute.

affects: >=5.0.0

Errors

Common errors & fixes

Error: Cannot find module 'vedadb-cli'

Package not installed globally or missing from PATH.

fix

Run 'npm install -g vedadb-cli' to install globally.

Error: connect ECONNREFUSED ::1:6380

VedaDB server not running on localhost:6380.

fix

Ensure VedaDB server is started (e.g., 'vedadb-server start') or use -h to specify a running host:port.

Error: Client does not support authentication protocol requested by server; consider upgrading MySQL client

Server uses an auth plugin not supported by this CLI version.

fix

Update VedaDB CLI to latest version or reconfigure server to use mysql_native_password.

Upgrade

Version history

5.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

18 hits · last 30 days

node