Caesar Research
Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collec
- Rating
- 3.9 (337 reviews)
- Downloads
- 2,892 downloads
- Version
- 1.0.0
Overview
Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collections.
Complete Documentation
View Source →
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_hereResearch
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 <job-id>
caesar research watch <job-id>
caesar research events <job-id>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 <job-id> "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 <job-id> "question" --wait=false
caesar chat history <job-id>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 IDThen use the session ID:
caesar research create --brainstorm <session-id> "How does CRISPR gene editing work?"Collections
Group files for research context:
caesar collections create "Dataset Name" --description "Optional description"Tips
- For broad topics, use
--autoto let Caesar pick optimal settings. - Use
--loops 3or higher for complex multi-faceted questions. - Use
--reasoningfor questions requiring deep analysis. - Pipe output through
jqto extract specific fields:caesar research get| jq '.content' - Chain brainstorm → research for best results on ambiguous queries.
Installation
openclaw install caesar-research
💻Code Examples
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 events <job-id>
### Research Options
| Flag | Description |
|------|-------------|
| `--no-wait` | Return immediately with job ID |
| `--model <name>` | `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 <id>` | 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 history <job-id>
## Brainstorm
Get clarifying questions before research to improve results:caesar research create --brainstorm <session-id> "How does CRISPR gene editing work?"
## Collections
Group files for research context:caesar research get <job-id>
caesar research watch <job-id>
caesar research events <job-id>Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
Adversarial Prompting
Adversarial analysis to critique, fix.