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.
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.
This CLI is installed as part of the cli-anything-chromadb package:
pip install cli-anything-chromadb
Prerequisites:
# 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"
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-chromadb
# Enter commands interactively with tab-completion and history
Server health and version commands.
| Command | Description |
|---|---|
heartbeat | Check ChromaDB server health |
version | Get ChromaDB server version |
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 |
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 |
Semantic search against collections.
| Command | Description |
|---|---|
search --collection C --text T | Semantic search |
All commands support dual output modes:
--json flag): Structured JSON for agent consumption# Human output
cli-anything-chromadb server heartbeat
# JSON output for agents
cli-anything-chromadb --json server heartbeat
When using this CLI programmatically:
--json flag for parseable output--host to connect to non-default ChromaDB instances1.0.0