Commands

Research

librarium research "Compare managed PostgreSQL services" --only exa,openai --dry-run --json
librarium research "Compare managed PostgreSQL services" --deep --only exa,openai --max-cost 1
librarium research "Compare managed PostgreSQL services" --deep --no-wait

Option	Meaning
--deep	Choose deep variants; quick is the default
--only <names>	Comma-separated sources, engines, or saved groups
--skip <names>	Remove names after group expansion
--max-cost <usd>	Limit which sources start using a USD budget
--dry-run	Return a planned Run without provider calls or storage
--no-wait	Detach deep work; invalid for quick except dry runs
--json	Write the public Run as JSON

See costs and limits for budget selection and billing caveats. A named source without credentials is an error.

Read and summarize

librarium show <run-id> --wait --json
librarium show <run-id> --source exa
librarium summarize <run-id> --source openai --verify --json

show and summarize use the latest Run when no id is supplied. show --wait picks up in-progress research. summarize makes a new paid Run linked by summary_of; the source Run stays unchanged. Verification uses the same synthesis source and can also spend. Source choice is configured summarize.source, then --source, then the first set-up source in openai, claude, gemini, openrouter order. A failed summary preserves its error instead of trying another source.

Discover and configure

librarium sources --json
librarium groups add editorial exa claude
librarium groups remove editorial
librarium setup
librarium setup --check
librarium mcp

Save recurring selections as groups. Offline setup checks inspect credential presence; setup --live checks authentication with providers. The MCP server exposes exactly research, get_run, and list_sources.

Local tools

Command	Purpose
browse	Saved Run history
html [id] --output report.html	HTML export
jsonl [id] --output run.jsonl	JSONL export
usage	Known provider-reported spend
cleanup --dry-run	Preview configured retention
config path, config show, config set <path> <value>	Inspect or edit v3 config
completions bash|zsh|fish	Shell completions
upgrade	Update an existing installation
install-skill --force	Install the version-matched bundled skill

See migration replacements for retired commands, and recovery before manually repeating ambiguous provider work.