Spira CLI

Command line client for Spira.

⚠️ Database feature is deprecated. The Brand Machine "Database" subsystem has been retired from the product. The spira dataBase glob | read | grep | search commands still exist for backward compatibility only — do NOT build new workflows against them. Use the Brand Machine web dashboard or the per-user cc-engine workspace (spira workspace / dashboard Workspace tab) instead. The bundled spira-database skill has been removed so agents are no longer guided toward these commands.

Install

npm install -g @spira-lab/cli

Usage

spira --help
spira auth login
spira ai models list
spira ai models list --media-type audio
spira ai jobs create --model-id nano-banana-2 --inputs-json '{"prompt":"A product photo"}' --wait
spira ai jobs create --model-id elevenlabs-music-generation --inputs-json '{"prompt":"A short ambient cue","duration":"10"}' --wait
spira workflows node-catalog --view summary --json
spira workflows node-catalog --view full --node-type textInput --node-type textChatLlm --json
spira workflows create --name "Product launch workflow"
spira workflows update <workflowId> --workflow-definition-json '{"nodes":[],"edges":[]}'

Use spira --json when you need machine-readable output.

ai jobs create --wait prints the job ID and status changes to stderr while it waits. Its final stdout is a compact result containing the job ID, model, status, result type, and result URLs. Use spira --json ai jobs status <jobId> when you need the full job and provider execution details.