Skip to content

Gosset CLI ​

The Gosset CLI queries the Gosset database from your terminal: drugs, clinical trials, companies, deals, news and conference abstracts, plus two trial models, progression (PTRS) and timeline. Output is JSON by default, so it works with jq, pandas, spreadsheets or an AI agent.

It ships in the same package as the Python SDK: pip install gosset gives you both the gosset command and import gosset.

Why the CLI ​

  • You type names, not ids. Pass a target, disease, drug, company or modality by name and the server resolves it. --target PD-1, --disease "atopic dermatitis", --drug pembrolizumab all work. A Gosset id works too.
  • JSON by default. Pipe it into jq, hand it to an agent, or add --table to read it yourself.
  • One command per dataset. drugs, trials, companies, deals, news and abstracts share the same paging, output and filter flags.

60-second tour ​

bash
pip install gosset
gosset auth                          # one-time browser sign-in; the key is stored

# The TL1A landscape, most advanced first
gosset drugs --target TL1A --table

# Phase 3 semaglutide trials
gosset trials semaglutide --phase 3 --table

# TL1A deals, newest first
gosset deals --target TL1A --table

# Every abstract that reported on the DESTINY-Breast09 trial, at any meeting
gosset abstracts --nct NCT04784715 --table

# Names only, ready for the next step in a script
gosset drugs --target TL1A --phase 3 | jq -r '.[].name'

Real output of gosset drugs --target TL1A --fields name,phase,developers --table --limit 5:

name                     phase  developers
-----------------------  -----  --------------------------------------
afimkibart               3      Roche, Roivant Sciences, Pfizer
duvakitug                3      Teva Pharmaceutical Industries, Sanofi
tulisokibart             3      Merck
risankizumab + ABBV-701  2      AbbVie
ABBV-701                 2      AbbVie

… showing 5 of 75 total

All commands ​

CommandUse it for
drugsAssets by name, target, disease, modality, developer, phase
trialsTrials by drug, disease, target, sponsor, phase, status, registry, dates
companiesCompanies by name, pipeline focus, country, type, stage
dealsLicensing, M&A and financing by drug, target, disease, party, type, value, date
newsNews and press releases by text, drug, disease, company, category, date
abstractsConference abstracts by drug, meeting, year, trial, target, impact
ptrs, timelineProgression estimate and predicted completion date for one trial
schemaThe field names each dataset returns
usageHow much of your plan you have used
skillsReady-made workflows for AI agents
auth, get-token, versionSign-in and housekeeping

The command reference lists every flag and default.

How names become filters ​

You passThe serverWhat it matched (live, November 2026)
--target TL1Afinds the target and its ontology classTNF-like cytokine 1A, 18 target records
--disease "breast cancer"classifies the disease and includes narrower diseasesbreast cancer and its sub-classes
--drug Keytrudamatches the drug's names, brands and codespembrolizumab (so does MK-3475)
--company AstraZenecafinds the company and its group recordsAstraZeneca, 18 company records
--target 680389902c09a077cc7ea8dauses the Gosset id as givenone target record

Add --debug to see the query the CLI sent. The JSON response from the API also says what each name matched; see Query API.

A name that matches nothing never widens the search

If a name can't be resolved (a typo, or not in the database), you get an empty result, a message on stderr and exit code 2. The filter is never dropped.

bash
$ gosset drugs --target notarealtarget
[]
No match: could not resolve 'notarealtarget' (target). Check spelling, or pass a Gosset id.

Where to next ​

Gosset Documentation