pi-librarian (pi extension)

A GitHub-focused librarian subagent for pi. Inspired by Amp's librarian.

Demo

https://github.com/user-attachments/assets/25e9fc3b-9557-4cce-bbdd-058d2758a564

What it adds

• librarian tool (GitHub-focused subagent)
• Supporting repo analysis tools:
• read_github
• search_github
• commit_search
• diff
• list_directory_github
• list_repositories
• glob_github

How it works

librarian spawns an isolated pi subprocess (--mode json --no-session) with only the GitHub tools above enabled, then returns the subagent's final answer.

Requirements

• GitHub CLI (gh) installed
• Authenticated GitHub session:

gh auth login

Location

This extension is project-local and auto-discovered from:

• .pi/extensions/pi-librarian/index.ts

Use /reload in pi after edits.

Notes

• Current port targets GitHub only (no Bitbucket Enterprise path yet).
• Tool output is JSON-formatted text for reliable downstream parsing.