Skip to main content
command CX Codex

research · eugeniughelbur — Claude Code command: what it does, how to install

Research a topic and get a sourced dossier. With free sources, Claude Code turns the returned results into a note.

MIT ★ 5,412 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain
Open on GitHub

What research does

Run /research with a topic. When PERPLEXITY_API_KEY is set, the script uses Perplexity Sonar; otherwise it searches free sources such as Wikipedia, HackerNews, arXiv, and Reddit. Use --free to choose the free route explicitly, or --academic to limit that route to scholarly sources.

In Perplexity mode, the script produces a dossier with key facts, a timeline, people and organizations, dissenting views, and sources, then saves a note under Research/Web/. In free mode, the agent builds the dossier from the script’s JSON results and saves a note with the source URLs. Fewer than three sources means the coverage is flagged as thin.

TAVILY_API_KEY and BRAVE_API_KEY can add web sources to free mode, but neither is required. Use --academic when the research should draw only on scholarly sources.

What it helps with

  • build a sourced dossier on a topic
  • compare key facts with dissenting views
  • trace a topic’s timeline
  • save research findings as a note

Example prompts for the agent

  • Research vector databases for RAG with /research vector databases for RAG.
  • Look into AI agent memory using /research AI agent memory.
  • Find scholarly work on AI memory with /research --academic AI memory.

How to install research

1Plugin marketplace

/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain

2Manually: put the files in place

.claude/commands/research.md

Call it with /research. For all projects use ~/.claude/commands/

Questions about research

How do I install research in Claude Code?

Run /plugin marketplace add eugeniughelbur/obsidian-second-brain, then /plugin install obsidian-second-brain@obsidian-second-brain. The command file is at .claude/commands/research.md.

What does research do?

It gathers material on a topic and prepares a dossier with sourced facts and follow-up questions. It uses Perplexity Sonar when PERPLEXITY_API_KEY is set, and free sources otherwise.

Can research search scholarly sources only?

Yes. Add --academic to use the academic-only free mode, which draws on arXiv, Semantic Scholar, OpenAlex, and CrossRef.

Source text

research.md · MIT
---
description: Web research with citations - Perplexity Sonar when an API key is set, free key-less sources (Wikipedia, HackerNews, arXiv, Reddit, and more) otherwise. Deep dossier with summary, facts, timeline, players, contrarian views, open questions
category: research
triggers_en: ["research this", "look up", "find information about", "perplexity research"]
triggers_de: ["recherchiere das", "schlag das nach", "finde Informationen über", "Perplexity-Recherche"]
triggers_es: ["investiga esto", "búscalo", "busca información sobre", "investigación con perplexity"]
triggers_pt: ["pesquise isto", "procure", "encontre informações sobre", "pesquisa perplexity"]
triggers_zh: ["研究一下这个问题", "帮我查资料", "搜索关于这个主题的信息", "做一份带引用的网络研究"]
---

Use the obsidian-second-brain skill. Execute `/research [topic]`:

1. Resolve the topic from the user's argument. Multi-word topics fine ("AI memory tools", "vector databases for RAG"). If no topic, ask: "What topic should I research?"

2. Run the script from the skill root (its absolute path was given at session start as **Skill root**; substitute it for `SKILL_ROOT`):
   ```bash
   uv run --directory "SKILL_ROOT" -m scripts.research.research "<topic>"
   ```
   The script auto-selects its mode: if `PERPLEXITY_API_KEY` is set it uses Perplexity Sonar (paid); otherwise it falls back to free, key-less sources. Pass `--free` to force free mode even when a key is set, or `--academic` (free mode only) to restrict to scholarly sources (arXiv, Semantic Scholar, OpenAlex, CrossRef). If `TAVILY_API_KEY` or `BRAVE_API_KEY` is set, that source joins the free-mode pool as an extra web source; without them the pool stays fully key-less - never require either.

3. Handle the output by mode:
   - **Paid mode** - the script prints a finished dossier (Summary, Key Facts with recency markers, Timeline, Key Players, Contrarian Views, Further Reading, Open Questions, Sources) and saves the AI-first note itself to `Research/Web/` plus a log line. Show the dossier verbatim, then surface the saved file path. Nothing else to do.
   - **Free mode** - the script prints a JSON block with `"mode": "free-sources"`, containing `results` (raw items per source: title, url, snippet/abstract, authors, year, points, comments), `stats`, and `warnings`. YOU synthesize the dossier from it:
     a. Read the JSON. If `stats.success` is false (fewer than 3 sources returned results), say so plainly and flag the thin coverage in Open Questions - do not pad.
     b. Write a dossier with the same structure as paid mode. Every Key Fact carries a recency marker and the source domain/URL it came from. Never invent facts to fill a section; if the sources are thin, the section is short or empty (see the anti-fabrication rule below).
     c. Save it yourself as an AI-first note at `Research/Web/YYYY-MM-DD - <slug>.md` per `references/ai-first-rules.md` (preamble, frontmatter with `type: research`, `ai-first: true`, a `sources` list of every result URL verbatim, tags). Append a one-line entry to the operation log (`Logs/YYYY-MM-DD.md` if it exists, else `log.md`).
     d. Show the dossier to the user and surface the saved path.

4. Plain English triggers: "research [topic]", "look up [topic]", "deep research on [topic]" (note: "do deep research" or "research deep" should route to `/research-deep` instead - the chained version), "find me info on [topic]".

5. If the user wants ALSO X discourse on the same topic, suggest running `/x-pulse [topic]` after this. If they want full vault-aware synthesis with propagation, suggest `/research-deep [topic]`.

6. Errors handled inside the script with auto-retry on transient failures. Surface fatal errors verbatim.

---

**AI-first rule:** Every note created or updated by this command MUST follow `references/ai-first-rules.md` - `## For future agent` preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`, plus type-specific fields), recency markers per external claim, mandatory `[[wikilinks]]` for every person/project/concept referenced, sources preserved verbatim with URLs inline, and confidence levels where applicable. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule. The vault is for future agent retrieval - not human reading.

**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.

© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain

Similar slash commands

All slash commands for Science and research →

research by other authors comes first.

research SuperClaude-Org research — a command for investigating complex questions beyond your knowledge cutoff. It breaks down the task automatically, runs parallel searches, and collects evidence with source attribution. CX Codex +1 ★ 23,950repo stars research microsoft research runs a five-iteration investigation of one topic in your codebase, tracing real code paths and citing a source for every claim. CX Codex +1 ★ 3,232repo stars research carlrannaberg research fans a question out to parallel subagents, reads their saved reports from /tmp, and merges the lot into one cited file. CX Codex +1 ★ 763repo stars research JDArmy research spawns a subagent that searches GitHub for evasion techniques, reads the code and stores the findings in a knowledge base. CX Codex +1 ★ 336repo stars wiki-research Ar9av wiki-research runs several rounds of web research on a topic, synthesizes the findings and files them as structured pages in an Obsidian wiki. CX Codex +1 2,800installs research-hub WenyuChiou The research-hub MCP server connects literature, research evidence, results, and manuscripts in a local workspace. It passes tasks to AI and lets researchers review its proposals. CX Codex +1 ★ 70repo stars perplexity-search dotneet perplexity-search is a Claude Code skill that queries the Perplexity API. It activates for current web lookups, research requests, and analytical questions. CX Codex +1 459installs researching-web julianobarbosa researching-web — a skill that routes your question to Perplexity over MCP and brings back a written answer: current releases, technology comparisons, accepted practice. CX Codex +1 200installs perplexity davila7 This skill wires Perplexity into Claude: web search, conversational answers, and deep research through an agent. Handy when you need current information rather than library docs. CX Codex +1 140installs deep-research samber A skill for deep research: parallel web searches, multi-source validation and a finished Markdown report with citations. CX Codex +1 5,700installs

From the same set51

The whole set →
obsidian-emerge obsidian-emerge surfaces hidden themes, emotional patterns, and unspoken conclusions across recent Obsidian vault notes. CX Codex +1 ★ 5,412repo stars obsidian-graduate The obsidian-graduate command for Claude Code turns an idea note into a project spec, tasks, kanban cards, and links. It moves a loose concept toward an execution plan. CX Codex +1 ★ 5,412repo stars obsidian-synthesize obsidian-synthesize — a Claude Code command that scans your Obsidian vault for unnamed patterns and automatically generates synthesis pages without prompting. Discovers connections between ideas you may have missed. CX Codex +1 ★ 5,412repo stars notebooklm notebooklm runs source-grounded research across your Obsidian vault with Gemini File Search. Useful when you need answers tied strictly to personal notes. CX Codex +1 ★ 5,412repo stars crew crew synchronizes a work logbook across Claude Code, Codex, Cursor, and Grok Bot via a local folder. Lets each agent see what others did, what patterns emerged, and decide next steps from a shared record. CX Codex +1 ★ 5,412repo stars obsidian-export obsidian-export generates a structured snapshot of an Obsidian vault as flat JSON, a single Markdown index, or an Open Knowledge Format bundle. CX Codex +1 ★ 5,412repo stars obsidian-world obsidian-world is a Claude Code command that loads context from an Obsidian vault in stages. It runs on requests to catch up or check current priorities. CX Codex +1 ★ 5,412repo stars obsidian-decide obsidian-decide — a Claude Code command that extracts decisions from a conversation and files them in Obsidian, as dated lines or, with --formal, as a full ADR. CX Codex +1 ★ 5,412repo stars

Project sponsors

Companies that keep this analytics open