spawningpool-cli-0.3.0 is not a library.

spawningpool-cli

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

This crate installs the spawningpool binary, the whole interface to 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

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:

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

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

License