Skip to content

research — CLI cheatsheet

Scope

research show-scope          # list entries in the sitemap (no crawl)

Sync (crawl + archive + index)

research sync                # full corpus (needs Ollama)
research sync --dry-run      # plan only, no network
research sync --no-embed     # archive + chunk, skip embeddings
research sync --only alignment-faking
research sync --limit 5      # first N entries (testing)
research sync --quiet        # no per-entry progress

research search "constitutional AI"
research search "interpretability circuits" --limit 3

Inspect

research list                # indexed entries
research list --json

MCP

research serve

Config resolution

  1. Environment variables (RESEARCH_DB, RESEARCH_ARCHIVE_DIR, …)
  2. The private settings: <data_root>/config/research.toml, [general] (Settings, or research config set)
  3. tool-chest.toml [research] section (shared defaults only; per-user values do not belong there)
  4. Built-in defaults — themselves resolved from tool-chest.toml's [workspace].data_root (default ~/tool-chest-data), not a fixed path

Archive layout

<data_root>/research/archive/<slug>/
    source.html    raw HTML
    article.md     extracted markdown + PDF text
    paper.pdf      full-paper PDF (when linked)
    meta.json      url, title, date, references