@fbraza/pi-cite

Pi extension with PubMed and literature search tools.

Packages

Package details

extensionskill

Install @fbraza/pi-cite from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@fbraza/pi-cite

Package: @fbraza/pi-cite
Version: 0.3.1
Published: Jun 20, 2026
Downloads: 234/mo · 234/wk
Author: fbraza
License: MIT
Types: extension, skill
Size: 100.6 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@fbraza/pi-cite

A standalone Pi extension providing literature-research tools for academic workflows. Registers two tools callable by the agent:

literature_search — literature workflow search against PubMed using a PubMed-ready query (MeSH [mh], [tiab], [pt], substance [nm], and Boolean logic), with streaming progress and deduplicated results.
pubmed_search — direct PubMed query (MeSH, [tiab], [pt], etc.).

Bundled skill

Ships with the literature skill (skills/literature/), which turns these tools into an end-to-end review workflow: verified-citation search, per-paper experiment extraction, and a structured hypothesis synthesis. Its frontmatter declares allowed-tools covering the extension's tools above, so the skill and extension are paired on purpose.

references/ — PubMed query syntax, API reference, and common queries.
scripts/ — Python helpers (extract_experiments.py, synthesis.py, generate_table.py, export_all.py) invoked by the skill.

Install

Published on npm as @fbraza/pi-cite:

# install into your user pi settings
pi install npm:@fbraza/pi-cite

# pin a specific version
pi install npm:@fbraza/pi-cite@0.1.0

# or try it for the current run only (no settings change)
pi -e npm:@fbraza/pi-cite

Pi provides the host packages (@earendil-works/pi-coding-agent, @earendil-works/pi-tui, typebox) at runtime, so they are declared as peer dependencies and are not bundled.

Develop

npm install
npm test            # run the unit tests
npm run pack:check  # preview the published tarball contents

Environment variables

Variable	Purpose
`NCBI_API_KEY` / `api_key` env	PubMed rate limit + E-utilities auth