{"skill":{"slug":"caesar-research","displayName":"Deep Research with Caesar.org","summary":"Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collections.","description":"---\nname: caesar-research\ndescription: Deep research using the Caesar API — run queries, follow up with chat, brainstorm, and manage collections.\nhomepage: https://www.caesar.org/\nmetadata: { \"openclaw\": { \"emoji\": \"🔬\", \"requires\": { \"bins\": [\"caesar\"], \"env\": [\"CAESAR_API_KEY\"] } } }\n---\n\n# Caesar Research\n\nCLI for [Caesar](https://www.caesar.org/) deep research. Runs multi-source research jobs with citations, follow-up chat, and brainstorming.\n\n## Setup\n\n```bash\ngo install github.com/alexrudloff/caesar-cli@latest\nexport CAESAR_API_KEY=your_key_here\n```\n\n## Research\n\nRun a query (waits for completion by default, prints events as they happen):\n\n```bash\ncaesar research create \"What are the latest advances in mRNA vaccines?\"\n```\n\nReturns JSON with `content` (synthesized answer with `[n]` citations) and a `results` array of sources.\n\nFire-and-forget:\n\n```bash\ncaesar research create \"query\" --no-wait\n# Returns: { \"id\": \"uuid\", \"status\": \"queued\" }\n```\n\nThen check on it:\n\n```bash\ncaesar research get <job-id>\ncaesar research watch <job-id>\ncaesar research events <job-id>\n```\n\n### Research Options\n\n| Flag | Description |\n|------|-------------|\n| `--no-wait` | Return immediately with job ID |\n| `--model <name>` | `gpt-5.2`, `gemini-3-pro`, `gemini-3-flash`, `claude-opus-4.5` |\n| `--loops N` | Max reasoning loops (default 1, higher = deeper research) |\n| `--reasoning` | Enable advanced reasoning mode |\n| `--auto` | Let Caesar auto-configure based on query |\n| `--exclude-social` | Skip social media sources |\n| `--exclude-domain x.com` | Exclude specific domains (repeatable) |\n| `--system-prompt \"...\"` | Custom synthesis prompt |\n| `--brainstorm <id>` | Use a brainstorm session for context |\n\n### Status Lifecycle\n\n`queued` → `searching` → `summarizing` → `analyzing` → `researching` → `completed` or `failed`\n\n## Chat (Follow-Up Questions)\n\nAsk follow-up questions about a completed research job:\n\n```bash\ncaesar chat send <job-id> \"How does this compare to traditional vaccines?\"\n```\n\nWaits for the response by default. The answer includes inline `[n]` citations referencing the original research sources.\n\n```bash\ncaesar chat send <job-id> \"question\" --wait=false\ncaesar chat history <job-id>\n```\n\n## Brainstorm\n\nGet clarifying questions before research to improve results:\n\n```bash\ncaesar brainstorm \"How does CRISPR gene editing work?\"\n# Prints questions with multiple-choice options and a session ID\n```\n\nThen use the session ID:\n\n```bash\ncaesar research create --brainstorm <session-id> \"How does CRISPR gene editing work?\"\n```\n\n## Collections\n\nGroup files for research context:\n\n```bash\ncaesar collections create \"Dataset Name\" --description \"Optional description\"\n```\n\n## Tips\n\n- For broad topics, use `--auto` to let Caesar pick optimal settings.\n- Use `--loops 3` or higher for complex multi-faceted questions.\n- Use `--reasoning` for questions requiring deep analysis.\n- Pipe output through `jq` to extract specific fields: `caesar research get <id> | jq '.content'`\n- Chain brainstorm → research for best results on ambiguous queries.\n","tags":{"latest":"0.0.1"},"stats":{"comments":0,"downloads":1057,"installsAllTime":40,"installsCurrent":0,"stars":2,"versions":1},"createdAt":1771257166582,"updatedAt":1778491556797},"latestVersion":{"version":"0.0.1","createdAt":1771257166582,"changelog":"- Initial release of caesar-research for deep multi-source research using the Caesar API.\n- Supports running research queries, follow-up chat, brainstorming sessions, and managing collections via CLI.\n- Includes flexible options for model selection, reasoning depth, source exclusion, and custom prompts.\n- Enables iterative workflows: brainstorm for clarifying questions, then create research jobs with context.\n- Provides lifecycle status tracking, citations, and JSON output for easy data handling.","license":null},"metadata":{"setup":[{"key":"CAESAR_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"alexrudloff","userId":"s17e17a6183q3yc9md3gxcwmq9885a7x","displayName":"alexrudloff","image":"https://avatars.githubusercontent.com/u/1984999?v=4"},"moderation":null}