agent-database-cli
Local CLI that lets agents connect, query, and inspect MySQL, Postgres, Redis, Oracle, MongoDB.
Tested on Linux and WindowsKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 9 known high or critical vulnerabilities (10 findings, one per affected package version) in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
crates:hickory-proto 0.25.2hickory-proto: NSEC3 closest-encloser proof validation enters unbounded loop on cross-zone responses (GHSA-3v94-mw7p-v465, high, no fix yet)crates:hickory-resolver 0.25.2hickory-resolver: Resolver::lookup() and Resolver::lookup_ip() APIs obscure DNSSEC validation failures (GHSA-5j98-2g5x-46v6, high, fixed in 0.26.2)
See 8 more
crates:postgres-protocol 0.6.11— GHSA-5x78-73v4-xg6w (high), fixed in 0.6.12crates:russh 0.45.0— GHSA-47hw-gvq5-r2gm (high), fixed in 0.63.1crates:russh 0.45.0— GHSA-4r3c-5hpg-58qr (high), fixed in 0.61.0crates:russh 0.45.0— GHSA-f5v4-2wr6-hqmg (high), fixed in 0.60.1crates:russh 0.45.0— GHSA-g9f8-wqj9-fjw5 (high), fixed in 0.60.3crates:russh 0.45.0— GHSA-vp5q-ff62-jwqv (high), fixed in 0.65crates:russh 0.45.0— GHSA-wwx6-x28x-8259 (high), fixed in 0.61.1crates:russh-cryptovec 0.7.3— GHSA-g9f8-wqj9-fjw5 (high), fixed in 0.60.3
Linux x86_64
You need first
- Runtimes:
Node.js >=20 - Needs the network
Install via npm global
npm install -g agent-database-cli
Check that it works
agent-database-cli --help 2>&1The output should contain “Usage: agent-database-cli”.
First thing to try
agent-database-cli list 2>&1Run agent-database-cli list to see the supported database types and your configured connections.
Windows x86_64
You need first
- Runtimes:
Node.js >=20 - Needs the network
npm install -g agent-database-cli
npm install -g agent-database-cli
Where the README and reality differ
- README: agent-database-cli list --format json / 默认格式
What worked: global --format must be before subcommand (agent-database-cli --format json list); default list already outputs json without flag
Check that it works
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User'); agent-database-cli --helpThe output should contain “list 展示支持的数据库类型和本地连接”.
First thing to try
agent-database-cli install-skill --dry-runRun agent-database-cli list to see the supported database types and your configured connections.
What it does
- List supported database types and connectionsTested
How to use it
- Add your connections to
config.jsonin the.agent-database-clifolder in your home directory. - Run
agent-database-cli listto see the supported types and your configured connections.
- Add your connections to
- Run SQL, Redis and MongoDB commandsNot shown working
- Inspect database metadata such as tables and columnsNot tested
- Edit the configuration in a local pageNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Windows x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Other systems
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- list supported database types and configured connections
- execute SQL, Redis commands, or MongoDB JSON commands
- inspect database metadata such as tables, columns, and collections
- enforce per-connection read-only mode and command blacklist
- edit connections visually in a local page with validation
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.4.1
Differences the test machine hit
- README: README grep shows only list/editor/install-skill command lines, no exec/meta example lines
In the test: exec/meta syntax discovered via exec --help / meta --help: exec --db <DB> --command <COMMAND>, meta --db <DB> --type tables|columns|collections|keys - README: README badge shows release v0.4.0
In the test: installed version is 0.4.1 (seen in editor health)
Windows x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 0.4.1
Differences the test machine hit
- README: config at ~/.agent-database-cli/config.json auto-created
In the test: directory ~/.agent-database-cli not auto-created, mkdir -Force needed before writing config.json - README: (Windows steps)
In the test: pickfit ran these steps in PowerShell 7 (pwsh 7.6.9) as a standard user; the built-in Windows PowerShell 5.1 is not verified and does not run `&&`. - README: (Windows steps)
In the test: On Windows, open a new terminal after installing so PATH includes the tool; the sandbox refreshed PATH in the same session instead.