Deep Research with Caesar.org
by @alexrudloff
Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collections.
clawhub install caesar-research📖 About This Skill
name: caesar-research description: Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collections. homepage: https://www.caesar.org/ metadata: { "openclaw": { "emoji": "🔬", "requires": { "bins": ["caesar"], "env": ["CAESAR_API_KEY"] } } }
Caesar Research
CLI for Caesar deep research. Runs multi-source research jobs with citations, follow-up chat, and brainstorming.
Setup
go install github.com/alexrudloff/caesar-cli@latest
export CAESAR_API_KEY=your_key_here
Research
Run a query (waits for completion by default, prints events as they happen):
caesar research create "What are the latest advances in mRNA vaccines?"
Returns JSON with content (synthesized answer with [n] citations) and a results array of sources.
Fire-and-forget:
caesar research create "query" --no-wait
Returns: { "id": "uuid", "status": "queued" }
Then check on it:
caesar research get
caesar research watch
caesar research events
Research Options
| Flag | Description |
|------|-------------|
| --no-wait | Return immediately with job ID |
| --model | gpt-5.2, gemini-3-pro, gemini-3-flash, claude-opus-4.5 |
| --loops N | Max reasoning loops (default 1, higher = deeper research) |
| --reasoning | Enable advanced reasoning mode |
| --auto | Let Caesar auto-configure based on query |
| --exclude-social | Skip social media sources |
| --exclude-domain x.com | Exclude specific domains (repeatable) |
| --system-prompt "..." | Custom synthesis prompt |
| --brainstorm | Use a brainstorm session for context |
Status Lifecycle
queued → searching → summarizing → analyzing → researching → completed or failed
Chat (Follow-Up Questions)
Ask follow-up questions about a completed research job:
caesar chat send "How does this compare to traditional vaccines?"
Waits for the response by default. The answer includes inline [n] citations referencing the original research sources.
caesar chat send "question" --wait=false
caesar chat history
Brainstorm
Get clarifying questions before research to improve results:
caesar brainstorm "How does CRISPR gene editing work?"
Prints questions with multiple-choice options and a session ID
Then use the session ID:
caesar research create --brainstorm "How does CRISPR gene editing work?"
Collections
Group files for research context:
caesar collections create "Dataset Name" --description "Optional description"
Tips
--auto to let Caesar pick optimal settings.--loops 3 or higher for complex multi-faceted questions.--reasoning for questions requiring deep analysis.jq to extract specific fields: caesar research get | jq '.content' ⚙️ Configuration
go install github.com/alexrudloff/caesar-cli@latest
export CAESAR_API_KEY=your_key_here
📋 Tips & Best Practices
--auto to let Caesar pick optimal settings.--loops 3 or higher for complex multi-faceted questions.--reasoning for questions requiring deep analysis.jq to extract specific fields: caesar research get | jq '.content'