spawningpool-cli 0.3.0

CLI for spawningpool — create hyper-specific, 0-waste agents
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

# spawningpool-cli

[![crates.io](https://img.shields.io/crates/v/spawningpool-cli.svg)](https://crates.io/crates/spawningpool-cli)
[![license](https://img.shields.io/crates/l/spawningpool-cli.svg)](https://github.com/ivypuckett/spawningpool/blob/main/LICENSE)

`spawningpool` — create hyper-specific, 0-waste agents from the command line.

This crate installs the `spawningpool` binary, the whole
interface to [spawningpool](https://crates.io/crates/spawningpool). A
**specialist** is a saved template of `(provider, model, system prompt, tools)`
you instantiate with a prompt and run. Everything you define lives in one JSON
registry on disk.

## Install

```sh
cargo install spawningpool-cli
```

This installs the `spawningpool` binary into `~/.cargo/bin`. Make sure that
directory is on your `PATH`, then invoke the CLI as `spawningpool`.

## The model

Four entity kinds, defined in order — each references the previous by name:

```text
provider   a wire protocol + endpoint + key  (e.g. Anthropic, or a local LM Studio)
  └─ model       an API id + its token limits, under a provider
       └─ specialist   a system prompt + tools, on a model
tool       an executable script a specialist may call (referenced by specialists)
```

Run bare `spawningpool` at any time — it reads where you are in this progression and prints
the exact next command.

## Quickstart

```sh
# 1. Define a provider (hosted Claude)
spawningpool define provider anthropic --api anthropic \
  --base-url https://api.anthropic.com --api-key-env ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=sk-ant-...

# 2. Define a model under it
spawningpool define model claude-opus-4-8 --provider anthropic \
  --max-tokens 4096 --context-window 200000

# 3. Define a specialist
spawningpool define specialist namer --provider anthropic --model claude-opus-4-8 \
  --system-prompt 'You suggest one short, memorable name. Reply with only the name.'

# 4. Run it
spawningpool run --specialist namer --prompt 'A CLI that spawns AI specialists'
```

By default `run` prints a JSON result envelope (the assistant text is the
`output` field); pipe it to `jq -r .output` for just the text, or pass
`--output plaintext` to stream the response to the terminal.

Browse and manage everything in an interactive terminal UI with `spawningpool tui`.

## Documentation

Full guides — quickstart, CLI reference, writing tools, and configuration — live
in [the `docs/` folder](https://github.com/ivypuckett/spawningpool/tree/main/docs).

## License

Licensed under the [MIT license](https://github.com/ivypuckett/spawningpool/blob/main/LICENSE).