Skip to content

CLI reference

Every package ships a CLI (and most a matching kaos-*-serve MCP server). Run kaos-<tool> --help, or kaos-<tool> <command> --help, for full usage. All follow the same conventions: --json for structured output, human-readable by default, errors to stderr. See the package reference for versions and install.

ToolSubcommandsWhat it does

| kaos-core | tools artifacts config vfs creds auth | Inspect the runtime: tools, artifacts, settings, VFS, credentials, auth. | | kaos-mcp | serve list-tools list-resources | Serve a runtime over MCP; list its tools and resources. | | kaos-llm-client | check chat profiles config | Check connectivity, chat, inspect model profiles and config. | | kaos-llm-core | check examples summarize classify analyze | Run LLM programs: summarize, classify, analyze. | | kaos-agent | chat | Interactive or one-shot agent chat (also: kaos-extract, kaos-agents-serve). | | kaos-pdf | extract search info outline page render classify serve | Extract, search, render, and classify PDFs. | | kaos-office | extract search metadata xlsx-extract write-docx redline | DOCX / PPTX / XLSX extraction, authoring, and redlining. | | kaos-tabular | query describe sample export read | Run SQL over CSV / Parquet / JSON / XLSX / SQLite. | | kaos-source | discover preview info materialize inspect-archive | Discover and materialize sources; inspect archives. | | kaos-web | extract metadata fetch search browser-doctor serve | Web extraction, fetch, search, and browser diagnostics. | | kaos-nlp | tokenize segment compare find search index hash duplicates encode vocab analyze | Tokenize, segment, BM25 search/index, fuzzy hashing, dedup. | | kaos-ml | info | Classical ML over the content AST (Python API is the primary surface). | | kaos-nlp-transformers | info prefetch | Diagnostics and model cache-warming (prefetch) for embeddings/rerank/NLI. | | kaos-graph | serve version | Serve the graph engine over MCP; print version. | | kaos-names | generate vocabulary | Generate friendly handles; inspect the word lists. | | kaos-ui | list info new doctor | Scaffold apps: list/inspect templates, create a project, health-check. |