# open-source-librarian

The open-source-librarian subagent investigates open-source libraries and codebases, tracing implementations and linking to exact GitHub lines. Use it for source-level and change-history questions.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1064 repo stars
- Author: jarrodwatts
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/agents/open-source-librarian.md
- Updated: 2026-01-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/open-source-librarian

## What it does

open-source-librarian handles questions about libraries and large repositories. It looks for implementation details, source locations, documentation, issues, pull requests, and the background of code changes. Its answers are based on code evidence and GitHub permalinks rather than a high-level summary.

The configuration gives it file search and reading tools, `Bash`, `WebFetch`, `LSP`, `WebSearch`, Context7, Exa, and GitHub search, along with `TodoWrite` and `Skill`. In Claude Code, place the agent file at `.claude/agents/open-source-librarian.md`. That GitHub link trail matters when you need to verify the exact lines behind an answer.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/open-source-librarian.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/open-source-librarian.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/open-source-librarian.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/agents/open-source-librarian.md

## When to use it
- locate a function inside an open-source repository
- explain a library feature from its source code
- trace the background of a codebase change
- back an implementation answer with GitHub line links

## Example prompts
- Explain how React Query implements stale time and link to the relevant source lines.
- Find where Zod checks email formats and provide a GitHub permalink.
- Research the routing change in Next.js and connect the explanation to issues and pull requests.

## Similar
- [Open Source Release Checklist Builder (YAML)](https://affpapa.org/en/nevibecode/prompts/open-source-release-checklist-builder-yaml.md) — prompt · ★ 178201 repo stars
- [open-source-marketing](https://affpapa.org/en/nevibecode/skills/open-source-marketing.md) — skill · ★ 88 repo stars
- [open-sourcing](https://affpapa.org/en/nevibecode/skills/open-sourcing.md) — skill · 1900 installs
- [open-source-company-strategy](https://affpapa.org/en/nevibecode/skills/open-source-company-strategy.md) — skill · 13800 installs
- [oss-contributor-onboarding](https://affpapa.org/en/nevibecode/skills/oss-contributor-onboarding.md) — skill · 13700 installs
- [open-source](https://affpapa.org/en/nevibecode/commands/open-source.md) — command · ★ 1988 repo stars

From the same set: [jarrodwatts/claude-code-config](https://affpapa.org/en/nevibecode/by/jarrodwatts/claude-code-config.md) — 20 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
