@fbraza/pi-cite

Pi extension with PubMed, Semantic Scholar, literature search, and full-text retrieval 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.2.0
Published: Jun 17, 2026
Downloads: not available
Author: fbraza
License: MIT
Types: extension, skill
Size: 142.2 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 four tools callable by the agent:

literature_search — PubMed-first search with optional Semantic Scholar supplementary metadata.
pubmed_search — direct PubMed query (MeSH, [tiab], [pt], etc.).
fetch_fulltext — retrieve a paper PDF via PMC → publisher OA → fallback.
(semantic_scholar helper used internally by the search tools.)

Bundled skill

Ships with the literature skill (skills/literature/), which turns these tools into an end-to-end review workflow: verified-citation search, full-text retrieval, 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/Semantic Scholar query syntax, API reference, and full-text access routines.
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
`SEMANTIC_SCHOLAR_API_KEY`	Enables Semantic Scholar supplementary search