Research Logger
Search the web for a topic, find a relevant GIF, and create a structured Bear note using a research template.
Requirements
- grizzly CLI (Bear notes) —
go install github.com/tylerwince/grizzly/cmd/grizzly@latest - BRAVE_API_TOKEN — for web search (optional, falls back to DuckDuckGo)
- GIPHY_API_KEY — for GIF matching (optional, uses public beta key as fallback)
Usage
bash scripts/research_logger.sh "quantum computing" "tech,physics"
Parameters
- topic (required) — The research topic to search and log
- extra_tags (optional) — Comma-separated additional Bear tags
How It Works
- Web Search — Queries Brave Search API (or DuckDuckGo fallback) for top results
- GIF Match — Searches Giphy for a relevant GIF to include as supporting media
- Template Fill — Reads
references/research_template.mdand fills all placeholders - Bear Note — Creates a Bear note with the filled template via
grizzly
Template Placeholders
The references/research_template.md file uses these placeholders:
| Placeholder | Source |
|---|---|
{topic} | User-provided topic |
{date} | Current date (YYYY-MM-DD) |
{tags} | Auto-generated tags |
{summary} | Search result snippets |
{finding1-3} | Top 3 search snippets |
{links} | Source URLs from search |
{media_alt} / {media_url} | Matched GIF |
{action1-3} | Default action items |
Notes
- If
grizzlyis unavailable, the note is saved as a markdown file in~/ - If no Brave API token is set, DuckDuckGo HTML search is used as fallback
- GIF search uses Giphy's public beta key if no API key is provided