@spoolis/cli

Spoolis CLI

The official command-line tool for compiling, creating, reading, and verifying Spools.

Install

npm i -g @spoolis/cli

Set up an API key

Create a key at spoolis.com/dashboard/api-keys, then set it in your environment:

export SPOOLIS_API_KEY="your-key"

The CLI uses https://spoolis.com by default. Set SPOOLIS_API_URL to use another Spoolis API host.

Examples

Compile text and review grounded terms, suggested conditions, and questions separately:

spoolis compile "Design a logo for $500"

Create a Spool. Suggested conditions are never included automatically. Add only the conditions you choose:

spoolis create "Design a logo for $500" \
  --condition "Provide the final logo as an SVG"

Read a human summary or the raw canonical JSON:

spoolis get spl_123
spoolis get spl_123 --json

Read the event history with human labels and canonical event names:

spoolis events spl_123

Run verification using the evidence already submitted to the Spool:

spoolis verify spl_123

Find API key management instructions:

spoolis keys

Scope

This release covers text compilation and creation, Spool reads, event history, and verification. It does not create API keys, submit evidence, or manage the full Spool lifecycle. It sends no telemetry and has no runtime dependencies.