Librarian

Librarian skill

• Purpose: fetch and search developer docs on your machine so answers are based on real sources
• Best use: when you need accurate API details, code examples, or version‑specific docs
• Prereqs: Bun is required at runtime even if installed via npm/pnpm; install it if missing
• Check package manager: command -v bun || command -v pnpm || command -v npm
• Install (global): prefer npm by default, but use what exists
  • If bun exists: bun add -g @iannuttall/librarian
  • Else if pnpm exists: pnpm add -g @iannuttall/librarian
  • Else: npm i -g @iannuttall/librarian
• Install Bun (if missing): curl -fsSL https://bun.sh/install | bash
• Setup: run librarian setup and add tokens if you need private GitHub or gated models
• Verify: librarian version
• Add a repo: librarian add owner/repo --docs docs --ref main
• Add a site: librarian add https://example.com/docs
• Ingest: librarian ingest --embed
• Find a library first: librarian library "nextjs" or librarian library --version 16.x "nextjs"
• Search a library: librarian search --library <name|id> "middleware"
• Search modes: --mode word|vector|hybrid (word = exact words, vector = meaning, hybrid = both)
• Pin to a version: librarian search --library <name|id> --version <label> "query"
• Use detect for version labels: librarian detect then pass --version <label>
• Get a doc: librarian get --library <name|id> docs/guide.md
• Get a slice: librarian get --library <name|id> --doc 12 --slice 5:40
• Update: librarian update (auto-detects bun vs npm)
• Non‑interactive: add --noprompt where supported to avoid prompts
• Safety: do not paste secrets into prompts or docs