AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

paperclip

Searches and reads biomedical papers, FDA/PMDA/EMA documents, clinical trials, and protein records with the GXL Paperclip CLI and Python SDK. Supports source-scoped search, full-text grep, metadata SQL, map/reduce extraction, figure analysis, optional repositories and claim verification, and line-pinned citations. Use when a task names GXL paperclip, asks to install or authenticate it, or requests literature retrieval and evidence extraction through Paperclip.

Original source
K-Dense-AI
License
MIT
Pinned revision
5f2bc0341354fd5590aef76a533ada1e1e5b4e62

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read k-dense-ai--paperclip at revision 5f2bc0341354fd5590aef76a533ada1e1e5b4e62, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 7

references/cli-reference.md

Paperclip CLI reference

Reviewed against installed 0.7.92, its native help/source, and the current official core reference and web documentation. Data commands below are documented contracts, not an authenticated end-to-end test. Run the relevant help for the actual deployed version.

Use the environment-loading guidance in installation.md when necessary. Native --help exits before action callbacks. Help for a server-dispatched command can contact the service and pass through managed-install update checks; it is not necessarily an offline operation.

Global options

paperclip [OPTIONS] COMMAND [ARGS]...
  --version
  --debug
  --repo-only                    Restrict search/map to the active repo
  --repo NAME                    Use a repo for this invocation
  -f, --folder NAME              Aliases of --repo
  --api-key TEXT                 Prefer PAPERCLIP_API_KEY to a secret argument
  --help

Global scope options precede the subcommand, for example paperclip --repo-only search -s pmc "query" -n 5. Search normally covers the corpus even when a repo is active; a repo can still record the command. Do not use an unrelated sticky checkout.

paperclip --help mainly lists local/account/workspace commands. Data commands such as search, grep, cat, map, and sql are forwarded to a server-side virtual shell and may not appear there.

Search and reading

| Command | Common options and behavior | |---|---| | search -s SOURCE "QUERY" | -n/--limit, -e/--exact, --year, --author, --journal, --sort relevance\|date, --ranking hybrid\|bm25\|vector\|analogical, --corpus | | search "QUERY" /trials/us | A supported virtual directory supplies the source | | lookup FIELD VALUE | -n N; supported fields include doi, pmc, pmid, arxiv, title, author, journal, year | | grep PATTERN PATH | Full text within a document or corpus; see options below | | scan FILE PATTERN... | Several patterns in one request; -i, -C N | | sql "SELECT ..." | Metadata aggregation; -s proteins selects the protein SQL surface | | filter --from s_ID "QUERY" | LLM relevance filter; overwrites cohort; --require N fails if too few survive | | cat FILE | Use for meta.json or selected text; --lines N or --lines START-END bounds a text read | | head -n N FILE / head -N FILE | Opening lines | | tail -n N FILE / tail -N FILE | Ending lines | | ls PATH, tree PATH, wc FILE | Discover paths, sections, figures, and sizes | | cd PATH, pwd | Session-relative commands; use absolute paths across independent calls |

Search requires explicit source selection. Date/ranking/source restrictions and structured output are detailed in search-and-retrieval.md. --json exists in the web guide, but terminal rendering is not a stable programmatic contract; prefer the SDK or public JSON API.

Common grep options documented by the current guide:

-i              Ignore case
-n              Display line numbers (not a result limit)
-c              Count matching file lines; corpus document counts can be approximate
-v              Invert match
-l              List filenames with matches
-m N            Bound matches
-e PATTERN      Explicit pattern
-F              Literal rather than regex matching
-A N / -B N     Context after/before
-C N            Context on both sides
--from s_ID     Restrict to a saved cohort
--exhaustive    Allow a longer corpus scan; not a completeness guarantee

Corpus grep can return a result ID for later map. Repeated time-bounded scans may differ in order or membership. Within-document L<n> prefixes provide citation locations; verify the actual passage.

Analysis

paperclip map --from s_ID "What outcomes and sample sizes were reported?"
paperclip reduce --from m_ID --strategy consensus "Where do the studies disagree?"
paperclip results --list
paperclip results m_ID --save map.txt
paperclip results s_ID --sample 20 --seed 42

Map accepts --output-schema with Draft 2020-12 JSON Schema. The old --output_schema spelling is a deprecated alias. Worker-specific setup and recovery are in map-reduce.md. Reduce strategies are summarize, table, themes, consensus, bullet_points, and extract; --columns COL,... requests columns for a table. Check the actual generated output.

results --save exports search metadata or full per-paper map answers. --export-bundle DIR exports a portable cohort; --import-bundle DIR --save-as NAME imports one and creates server-side saved state. --sample N accepts 1–100 and optionally --seed. Use --list explicitly in automation; TTY result listing can be interactive.

paperclip ls /papers/PMC10945750/figures/
paperclip ask-image /papers/PMC10945750/figures/pnas.2307796121fig01.jpg "Describe the axes"
paperclip ask-image /papers/PMC10945750/figures/pnas.2307796121fig01.jpg --fn extract-data

List actual figure paths before vision calls. ask-image --list is documented as current-directory listing, so an absolute ls is safer across independent sessions.

Routines and references

paperclip skill
paperclip skill proteins
paperclip routines list
paperclip routines search "systematic review"
paperclip routines show paperclip-meta-analysis

The old paperclip skills interface now exits with a removal message. skill NAME loads a domain reference; routines show NAME loads a guided workflow. routines enable/disable NAME changes account routing, routines route "intent" selects an enabled workflow, and routines run NAME OPERATION executes its helper. Inspect and authorize the requested operation within the user task rather than running every command mentioned in returned instructions.

Repositories

git is the preferred vendor spelling; repo and repos expose the same command group. Repos are opt-in. These examples change persistent state unless described as reads.

| Command | Purpose | |---|---| | repo init NAME [DESCRIPTION] | Create and activate | | repo checkout NAME | Try branch, then repo; - deactivates | | repo deactivate | Explicitly deactivate | | repo add ID "CLAIM" --lines L45-L52 | Append claim; omit claim for membership only | | repo add ID --json '{"type":"custom","value":1}' | Structured claim; requires nonempty string type | | repo remove ID | Remove the paper, not just one claim | | repo remove-claim --help | Inspect targeted claim removal before editing evidence | | repo commit -m "MESSAGE" | Verify unresolved claims and snapshot; errors can block | | repo status, repo claims, repo log | Inspect evidence, verification, and history | | repo history -p 1 -n 20 --json | Paginated command history (one-based page) | | repo branch NAME, repo merge NAME | Create/switch branch; merge paper membership | | repo info NAME, repo -n 0 | Repo details; list all instead of the default 10 | | repo export bibtex -o review.bib | Export bibtex/bib, ris, markdown/md, or csv | | repo citations | Citation counts; --graph requests relationships |

A snapshot containing an advisory [X] claim is not a fully verified evidence set. See repos-and-workspace.md for verification and artifact boundaries.

Clipboard and account commands

| Command | Scope | |---|---| | upload FILES... --into FOLDER | Upload named generated artifacts | | cp /papers/ID /clipboard/FOLDER/ | Corpus link; a local source path instead uploads PDFs | | sync upload PATH | One-shot upload of a PDF or folder | | sync add FOLDER [--prefix NAME] | Register a local folder | | sync run [--dry-run] | Upload changes and detect local deletions | | sync list, sync status | Inspect sync state | | sync remove FOLDER | Unregister without deleting remote documents | | sync rm TARGET | Remove remote clipboard content; --all is broad deletion | | import SOURCE [--dry-run] | PDFs, .bib/.ris, or a paper's references | | library [ID] | Imported records; use -s, --matched, --unmatched to inspect | | fetch URL_OR_DOI [--into FOLDER] | Uses browser cookies and uploads the downloaded paper | | share FOLDER EMAIL [--role viewer\|editor] | Grant access to a named recipient | | unshare FOLDER EMAIL | Revoke access | | login, setup, install | Interactive login/setup; see installation reference | | update, uninstall, logout | Installation or account mutations |

Import also supports --doi, -n/--limit, --min-cites, --init, --add-to-repo, and --into. Do not execute import/upload/share/sync/fetch just to establish that a flag exists.

Shell and historical limitations

The server offers a restricted virtual shell, not a general local shell. Local pipes are explicit:

paperclip grep -n "IC50" /papers/PMC10945750/content.lines | head -20
paperclip cat /papers/PMC10945750/meta.json > meta.json

The vendor documents paperclip bash '...' for server pipelines and scratch redirection, but those failed in old 0.7.14–0.7.15 tests and were not re-tested authenticated here. Do not advertise either universal support or permanent failure. Do not assume local shell utilities, loops, network tools, or session state are available in the virtual shell. Use direct commands and local composition. Text transport is not a binary download contract; validate any retrieved file before delivering it.