spawnllm 0.1.0

Subshell + MLX LLM-calling backends (Claude/Codex CLI, local MLX) shared across tools.

spawnllm

Subshell + MLX LLM-calling backends (Claude/Codex CLI, local MLX) shared across tools.

spawnllm centralizes the LLM-calling plumbing that small tools keep re-inventing: driving the claude and codex CLIs as subshells — with structured Pydantic output, model tiers, and faithful error capture — and running local Apple-Silicon MLX models with adapter fusion, prompt-cache reuse, and batched generation. Depend on it once and each tool keeps only its domain logic instead of its own copy of the backends.

Install

No install needed — run everything through uvx:

uvx spawnllm --help

uvx fetches spawnllm into a throwaway environment and runs it. To add it to a project instead:

uv add spawnllm

For the local MLX engine (Apple Silicon only), pull the extra:

uv add "spawnllm[mlx]"

Quickstart

List the backends spawnllm can drive:

uvx spawnllm backends

claude
codex
mlx

What problems does this solve?

• Duplicate subshell plumbing. Building claude/codex argv, piping stdin/stdout, teeing stderr, and turning non-zero exits into useful errors — written once, not re-derived per tool.
• Structured-output boilerplate. A Pydantic model becomes a JSON-schema constraint and a parsed, validated result the same way for every backend.
• Local MLX is fiddly. Adapter fusion, prompt-cache reuse, worker-thread lifecycle, and batched single-token generation live behind one engine instead of in every consumer.
• Behavior drift. Two tools that call the same models stay byte-for-byte consistent because they share the backend layer rather than each maintaining a copy.

Docs

Read the docs for the full guide and API reference.