cli

@debriefer/cli

Command-line interface for the Debriefer multi-source research engine.

Installation

Not yet published to npm. Build from the repo:

git clone https://github.com/chenders/debriefer.git
cd debriefer
npm install
npm run build
npm link -w packages/cli

Commands

debriefer debrief <name>

Research a subject across all configured sources, with optional AI synthesis.

Flag	Default	Description
--budget <usd>	1.0	Maximum cost per query in USD
--categories	all	Comma-separated source categories to use
--model <model>	claude-sonnet-4-20250514	Synthesis model
--prompt <text>	built-in	Custom system prompt for synthesis
--no-synthesis	—	Skip AI synthesis and return raw findings
--format <fmt>	text	Output format: text or json
--verbose	false	Show per-source progress and cost during execution

Requires ANTHROPIC_API_KEY unless --no-synthesis is passed.

debriefer sources

List available research sources and their availability status.

Flag	Default	Description
--category <cat>	all	Filter to a specific source category
--format <fmt>	text	Output format: text or json

Examples

# Research a subject with defaults (AI synthesis, text output, $1.00 budget)
debriefer debrief "Stanley Kubrick"

# Skip synthesis, output raw findings as JSON
debriefer debrief "Stanley Kubrick" --no-synthesis --format json

# Limit to structured data sources only, cap at $0.25
debriefer debrief "Stanley Kubrick" --categories structured --budget 0.25

# Show verbose progress while researching
debriefer debrief "Stanley Kubrick" --verbose

# List all available sources
debriefer sources

# List only news sources as JSON
debriefer sources --category news --format json

Documentation

See the monorepo README for full documentation.

License

MIT