kowalski-cli 1.2.0

Kowalski CLI Interface: A Rust-based agent for interacting with Ollama models
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# Kowalski CLI

**Crate version 1.2.0** ยท See [`ROADMAP.md`](./ROADMAP.md) and root [`README.md`](../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

```bash
# 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

```bash
# 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:

- docs: [`examples/knowledge-compiler/README.md`](../examples/knowledge-compiler/README.md)
- local runner: `.kowalski/extensions/knowledge-compiler/run`

Typical flow:

```bash
# 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.