CLI Anything Chromadb
Apps & Automationcli-anything-chromadbCLI Anything Chromadb is an Agent Skill for apps & automation published in the HKUDS/CLI-Anything repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/HKUDS/CLI-Anything/blob/HEAD/chromadb/agent-harness/cli_anything/chromadb/skills/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cli-anything-chromadb, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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