kowalski-cli 1.2.0

Kowalski CLI Interface: A Rust-based agent for interacting with Ollama models
Documentation

Kowalski CLI

Crate version 1.2.0 · See ROADMAP.md and root README.md.

Command-line interface for Kowalski operators and extension workflows.

Horde changes in 1.1.0 (since 1.0.0)

  • Added the first horde-focused app operators for markdown-defined orchestration (agent-app + extension workflow).
  • Added delegate/worker federation commands for Knowledge Compiler task execution and proof-run validation.
  • Improved run UX with serialized sub-agent traces and artifact path reporting.

Scope

kowalski-cli provides:

  • TemplateAgent REPL (run)
  • config checks (config check)
  • memory DB migrations (db migrate)
  • health diagnostics (doctor)
  • MCP checks (mcp ping, mcp tools)
  • federation smoke ops (federation ping-notify, with --features postgres)
  • extension discovery and execution (extension list, extension run)

The HTTP API server for UI and federation routes is the separate kowalski binary.

Quick start

# help
cargo run -p kowalski-cli -- --help

# interactive orchestrator REPL
cargo run -p kowalski-cli -- run -c config.toml

# diagnostics
cargo run -p kowalski-cli -- doctor
cargo run -p kowalski-cli -- config check config.toml

# MCP checks
cargo run -p kowalski-cli -- mcp ping -c config.toml
cargo run -p kowalski-cli -- mcp tools -c config.toml

Extensions

# discover extensions
cargo run -p kowalski-cli -- extension list

# run an extension command
cargo run -p kowalski-cli -- extension run knowledge-compiler help

Extension resolution order:

  1. Binary in PATH named kowalski-ext-<name>
  2. Local executable .kowalski/extensions/<name>/run

Federation-first app example

The first app example is the Knowledge Compiler extension:

Typical flow:

# terminal 1: start HTTP API server
cargo run -p kowalski --bin kowalski

# terminal 2: start worker
cargo run -p kowalski-cli -- extension run knowledge-compiler worker kc-worker-1

# delegate tasks
cargo run -p kowalski-cli -- extension run knowledge-compiler delegate kc.compile "kc.compile"

Notes

  • Use kowalski-cli for operators and extension orchestration.
  • Use kowalski for /api/* server routes.