Expand description
§kowalski-cli
Command line of Kowalski, a Rust multi-agent framework: agents with MCP tools and memory, and hordes (step pipelines with triggers) over Ollama or OpenAI-compatible models.
The operator UI and HTTP API are served by the kowalski
binary; kowalski-cli is the terminal side.
§Install
cargo install kowalski-cli
kowalski-cli --help§Commands
run— interactive agent REPLconfig check— validate a config filedb migrate— memory database migrationsdoctor— health diagnosticsmcp ping,mcp tools— check configured MCP serversextension list,extension run— discover and run extensionsfederation ping-notify— federation smoke test (with--features postgres)
kowalski-cli run -c config.toml
kowalski-cli doctor
kowalski-cli mcp tools -c config.toml§Extensions
extension run <name> resolves, in order:
- a binary in
PATHnamedkowalski-ext-<name> - a local executable
.kowalski/extensions/<name>/run
See the Knowledge Compiler example for a
delegate/worker flow against a running kowalski server.
§Documentation
§License
MIT — see LICENSE.
Modules§
- agent_
app_ ops - Local markdown-staged app CLI (
app.md/horde.md+agents/*.md). Execution rules live inkowalski_core::markdown_pipeline; this module wires HTTP chat, federation helpers, and filesystem paths. - config
- error
- extension_
ops - Generic extension runners for
kowalski-cli. - federation_
ops kowalski-cli federation *operators.- ops
- Operator commands: config validation, DB migrations, environment checks.
- run_ops
kowalski-cli run— interactive orchestrator REPL (chat + federation hints).