Agent Skills
› HKUDS/CLI-Anything
› cli-anything-chromadb
cli-anything-chromadb
GitHubChromaDB向量数据库的无状态CLI工具，支持通过HTTP API v2管理集合、文档及语义搜索。专为AI代理和自动化场景设计，提供JSON输出以方便程序解析，涵盖服务器健康检查、CRUD操作及交互式REPL模式。
触发场景
需要管理ChromaDB向量数据库集合或文档时
在自动化流程中执行语义搜索或数据入库时
安装
npx skills add HKUDS/CLI-Anything --skill cli-anything-chromadb -g -y
SKILL.md
Frontmatter
{
"name": "cli-anything-chromadb",
"description": "Command-line interface for ChromaDB - A stateless CLI for managing vector database collections, documents, and semantic search. Designed for AI agents and automation via the ChromaDB HTTP API v2."
}
cli-anything-chromadb
A stateless command-line interface for ChromaDB vector database, built on the HTTP API v2. Designed for AI agents and power users who need to manage collections, documents, and run semantic queries without a browser UI.
Installation
This CLI is installed as part of the cli-anything-chromadb package:
pip install cli-anything-chromadb
Prerequisites:
- Python 3.10+
- ChromaDB server running at localhost:8000 (or specify via --host)
Usage
Basic Commands
# Show help
cli-anything-chromadb --help
# Start interactive REPL mode
cli-anything-chromadb
# Check server health
cli-anything-chromadb --json server heartbeat
# List all collections
cli-anything-chromadb --json collection list
# Semantic search
cli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy"
REPL Mode
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-chromadb
# Enter commands interactively with tab-completion and history
Command Groups
server
Server health and version commands.
| Command | Description |
|---|---|
heartbeat |
Check ChromaDB server health |
version |
Get ChromaDB server version |
collection
Manage ChromaDB collections.
| Command | Description |
|---|---|
list |
List all collections |
create --name NAME |
Create a new collection |
delete --name NAME |
Delete a collection |
info NAME |
Get collection info |
document
Manage documents in collections.
| Command | Description |
|---|---|
add --collection C --id ID --document TEXT |
Add document(s) |
get --collection C |
Get documents |
delete --collection C --id ID |
Delete document(s) |
count --collection C |
Count documents |
query
Semantic search against collections.
| Command | Description |
|---|---|
search --collection C --text T |
Semantic search |
Output Formats
All commands support dual output modes:
- Human-readable (default): Tables, colors, formatted text
- Machine-readable (
--jsonflag): Structured JSON for agent consumption
# Human output
cli-anything-chromadb server heartbeat
# JSON output for agents
cli-anything-chromadb --json server heartbeat
For AI Agents
When using this CLI programmatically:
- Always use
--jsonflag for parseable output - Check return codes - 0 for success, non-zero for errors
- Parse stderr for error messages on failure
- Use
--hostto connect to non-default ChromaDB instances
Version
1.0.0
版本历史
- 6f372d3 当前 2026-08-20 06:43
