Skip to main content

Crate kowalski_cli

Crate kowalski_cli 

Source
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 REPL
  • config check — validate a config file
  • db migrate — memory database migrations
  • doctor — health diagnostics
  • mcp ping, mcp tools — check configured MCP servers
  • extension list, extension run — discover and run extensions
  • federation 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:

  1. a binary in PATH named kowalski-ext-<name>
  2. 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 in kowalski_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).