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

librarian

Librarian skill