grokipedia-search

Use grokir to search Grokipedia and retrieve pages.

Quick start

1. Ensure grokir is installed (once per machine):

# From the skill folder:
bash scripts/ensure_grokir.sh
# (installs grokir into ~/.local/bin)

2. Search (prefer JSON):

grokir --json search "postgres vacuum" -l 10 -o 0

3. Fetch a page by slug:

grokir --json page "JSON"

Important CLI quirks

• --json is a global flag and must come before the command:

  • ✅ grokir --json search "..."
  • ❌ grokir search "..." --json

• Pagination:

  • -l = limit (max results)
  • -o = offset

Workflow: research with citations

1. Run a broad search query (JSON).
2. Pick 3–8 top results by title/snippet.
3. For each promising result, fetch the page by slug.
4. Produce:
   • short summary
   • key takeaways
   • (optional) direct quotes/sections from content
   • citations as: Grokipedia:<slug>

Output handling

• grokir --json search ... returns a JSON array of objects like:

  • slug, title, snippet, relevance_score, view_count

• grokir --json page <slug> returns a JSON object with:

  • title, slug, description, content

Troubleshooting

• If install fails, check:
  • git can reach GitHub: git ls-remote https://github.com/bdbi/grokir.git HEAD
  • Go is installed: go version

Resources

scripts/

• scripts/ensure_grokir.sh: installs/builds grokir into ~/.local/bin/grokir if missing (clones https://github.com/bdbi/grokir via git and runs go build).